# Reconstruct 스킬 {/* #reconstruct-skills */}

Reconstruct 스킬은 제품 작업에 집중된 워크플로를 AI 에이전트에 제공합니다. 스킬마다 지침과 필요한 보조 템플릿이 있습니다. 작업에 맞는 스킬을 선택하세요. 하나를 사용해도 전체 제품 수명 주기가 자동 실행되지는 않습니다.

9개 워크플로는 연결된 MCP 클라이언트, Reconstruct 웹사이트 및 공개 [reconstruct-ai-skills 저장소](https://github.com/cryptify-corporation/reconstruct-ai-skills)에서 제공합니다. 에이전트별로 한 전달 방식을 선택하세요. 클라이언트가 MCP 리소스를 읽을 수 있다면 별도 로컬 설치는 선택 사항입니다.

## 사용 가능한 워크플로 {/* #available-workflows */}

| 스킬 | 용도 |
|---|---|
| `reconstruct-inspect` | 캡처 인터페이스 증거를 수집하고 상태와 흐름을 파악하여 범위에 합의합니다. |
| `reconstruct-design` | 디자인 토큰, 컴포넌트, 레이아웃 및 상호작용 상태를 정의합니다. |
| `reconstruct-build` | 프로젝트 기술 스택으로 합의한 인터페이스와 동작을 구현합니다. |
| `reconstruct-verify` | 가용 증거에 비추어 동작, 접근성 및 시각적 충실도를 검사합니다. |
| `reconstruct-backend` | 서버 동작, 계약 및 통합을 계획하고 구현합니다. |
| `reconstruct-entrepreneur` | 고객 문제를 조사하고 제품 기회를 검증합니다. |
| `reconstruct-brand` | 일관된 제품 정체성과 브랜드 에셋을 개발합니다. |
| `reconstruct-launch` | 출시 자료, 등록 페이지 및 보조 증거를 준비합니다. |
| `reconstruct-deploy` | 승인된 릴리스를 준비하고 배포하며 검증합니다. |

캡처 인터페이스는 가시 구조와 동작의 증거를 제공합니다. 원래 앱의 비공개 백엔드 구현은 노출하지 않습니다. 백엔드 워크플로는 사용자의 요구사항과 가용 계약으로 해당 동작을 설계합니다.

## 전달 방식 선택 {/* #choose-a-delivery-method */}

| 방식 | 제공 내용 | 사용 시점 |
|---|---|---|
| [MCP 리소스](#read-skills-through-mcp) | 기존 MCP 연결을 통한 워크플로 지침 및 보조 파일. | 클라이언트가 MCP 리소스를 검색하고 읽을 수 있어 별도 스킬 설치가 필요하지 않습니다. |
| [웹사이트 CLI](#install-from-the-website) | Reconstruct 검색 카탈로그에서 받은 로컬 스킬. | 에이전트의 로컬 스킬 시스템에 스킬을 등록하려는 경우. |
| [GitHub CLI](#install-from-github) | 공개 GitHub 저장소의 로컬 스킬. | 저장소 소스를 선호하고 파일이나 기록을 확인하려는 경우. |
| [수동 ZIP](#manual-installation) | 에이전트 스킬 디렉터리에 복사할 수 있는 전체 웹사이트 번들. | 수동 설치를 선호하거나 CLI를 사용하지 않는 경우. |
| [플러그인 및 확장](#plugins-and-extensions) | 스킬과 MCP 설정을 담은 클라이언트별 패키지. | 지원 클라이언트의 플러그인 또는 확장 시스템을 사용하는 경우. |

웹사이트 및 GitHub 설치는 같은 이름의 9개 워크플로를 제공합니다. 에이전트 하나에는 한 소스에서만 설치하여 중복 등록을 피하세요. 각 릴리스가 공개될 때까지 버전은 다를 수 있습니다.

## MCP로 스킬 읽기 {/* #read-skills-through-mcp */}

Streamable HTTP와 OAuth 또는 개인 MCP 토큰으로 **`https://reconstruct.dev/mcp`**에 에이전트를 연결하세요. 클라이언트별 설정은 [AI 에이전트 연결](/docs/ko/connect-ai-agents)을 참고하세요.

MCP 리소스를 지원하는 클라이언트는 기존 연결에서 동일한 지침을 검색하고 읽을 수 있습니다:

1. `resources/list`를 호출하여 카탈로그와 스킬 파일을 찾으세요.
2. 카탈로그 URI로 `resources/read`를 호출하세요:

   ```json
   {"uri":"skill://reconstruct/catalog.json"}
   ```

3. 카탈로그에서 워크플로를 선택하고 제공된 진입점을 읽으세요. 예:

   ```json
   {"uri":"skill://reconstruct/reconstruct-inspect/SKILL.md"}
   ```

4. `resources/list`에 제공된 리소스 URI에서 보조 파일을 읽으세요. 예를 들어 검사 템플릿은 다음과 같습니다:

   ```json
   {"uri":"skill://reconstruct/reconstruct-inspect/assets/scope.md"}
   ```

MCP resources를 지원하지 않으면 `list_skills`, 다음으로 `get_skill(uri="skill://reconstruct/reconstruct-build/SKILL.md")`을 호출하세요. 지원 파일은 카탈로그 URI를 사용합니다. 선택한 인터페이스에는 build를 읽고 inspect, design, verify는 필요할 때 추가하세요. 원격 클라이언트는 텍스트를 받으며 `asFile=true`의 경로와 해시는 신뢰하는 로컬 stdio만 지원합니다. 별도 설치가 필요 없고 캡처 컨텍스트 읽기를 소비하지 않습니다.

## 웹사이트에서 설치 {/* #install-from-the-website */}

웹사이트 루트 주소로 `skills` CLI를 사용하세요:

```sh
npx skills add https://reconstruct.dev
```

설치하지 않고 가용 스킬을 미리보세요:

```sh
npx skills add https://reconstruct.dev --list
```

선택한 워크플로를 Codex에 설치하세요:

```sh
npx skills add https://reconstruct.dev --skill reconstruct-inspect -a codex
```

9개 모두 Claude Code에 설치하세요:

```sh
npx skills add https://reconstruct.dev --skill '*' -a claude-code
```

CLI는 공개 검색 카탈로그를 읽고 선택한 스킬마다 아카이브를 받습니다. 각 아카이브에는 지침, 보조 파일, LICENSE 및 NOTICE가 있습니다. `npx`에는 Node.js와 npm이 필요하지만 원격 MCP 서버 연결에는 Node.js나 .NET SDK가 필요하지 않습니다.

설치 후 에이전트에 해당 작업에 선택한 스킬을 사용하도록 요청하세요. 스킬 선택과 활성화는 클라이언트에 따라 다릅니다. 캡처 데이터가 필요한 스킬에는 [인증된 Reconstruct MCP 연결](/docs/ko/connect-ai-agents)도 필요합니다.

## GitHub에서 설치 {/* #install-from-github */}

공개 저장소를 `skills` CLI 소스로 사용하세요:

```sh
npx skills add cryptify-corporation/reconstruct-ai-skills
```

전체 저장소 URL도 지원합니다:

```sh
npx skills add https://github.com/cryptify-corporation/reconstruct-ai-skills
```

설치하지 않고 가용 워크플로를 나열하세요:

```sh
npx skills add cryptify-corporation/reconstruct-ai-skills --list
```

한 워크플로를 Codex에, 또는 9개 모두를 Claude Code에 설치하세요:

```sh
npx skills add cryptify-corporation/reconstruct-ai-skills --skill reconstruct-inspect -a codex
npx skills add cryptify-corporation/reconstruct-ai-skills --skill '*' -a claude-code
```

두 CLI 소스 모두 `--skill`로 워크플로, `-a`로 대상 에이전트를 선택합니다. 대화형으로 선택하려면 생략하세요. 프로젝트 대신 사용자 전체 설치에는 `-g`를 추가하세요. 로컬 설치는 MCP 서버를 설정하지 않습니다. 캡처 증거를 위해 [Reconstruct MCP를 연결](/docs/ko/connect-ai-agents)하세요.

## 수동 설치 {/* #manual-installation */}

1. [전체 스킬 번들](https://reconstruct.dev/downloads/reconstruct-skills.zip)을 받으세요.
2. 아카이브를 풀고 `skills/` 아래에서 원하는 폴더를 선택하세요.
3. 해당 폴더를 에이전트가 지원하는 스킬 디렉터리에 복사하세요. 번들의 LICENSE와 NOTICE를 설치된 배포본과 함께 보관하세요.
4. 클라이언트가 요구하면 에이전트 스킬을 다시 로드하세요.

전체 번들은 9개 워크플로와 템플릿을 포함합니다. CLI에는 위의 웹사이트 루트 주소를 사용하세요. 전체 ZIP은 수동 다운로드용입니다.

## 플러그인 및 확장 {/* #plugins-and-extensions */}

GitHub 저장소는 클라이언트별 설치용 Reconstruct 패키지도 제공합니다.

### Claude Code 플러그인 {/* #claude-code-plugin */}

Claude Code에서 저장소 마켓플레이스를 추가하고 Reconstruct 플러그인을 설치하세요:

```text
/plugin marketplace add cryptify-corporation/reconstruct-ai-skills
/plugin install reconstruct@reconstruct
```

그런 다음 `/mcp`를 실행하고 `reconstruct`를 선택하여 브라우저 로그인을 완료하세요. 플러그인은 스킬 지침과 MCP 설정을 포함합니다.

### Gemini CLI 확장 {/* #gemini-cli-extension */}

```sh
gemini extensions install https://github.com/cryptify-corporation/reconstruct-ai-skills
```

Cursor 등 클라이언트별 패키지는 [저장소 설치 지침](https://github.com/cryptify-corporation/reconstruct-ai-skills#install), 인증은 [연결 가이드](/docs/ko/connect-ai-agents)를 참고하세요. 저장소 패키지는 공개 플러그인 마켓 승인과 무관하게 이용할 수 있습니다.

## 에이전트 검색 {/* #agent-discovery */}

공개 [스킬 검색 카탈로그](https://reconstruct.dev/.well-known/agent-skills/index.json)는 스킬의 이름, 설명, 아카이브 URL 및 SHA-256 해시를 나열합니다. 아카이브에는 보조 템플릿이 있어 설치해도 상대 파일 참조가 유지됩니다.

개별 지침과 보조 파일은 `https://reconstruct.dev/.well-known/agent-skills/` 아래에도 있습니다. 예:

- 검사 지침: `https://reconstruct.dev/.well-known/agent-skills/reconstruct-inspect/SKILL.md`
- 검사 범위 템플릿: `https://reconstruct.dev/.well-known/agent-skills/reconstruct-inspect/assets/scope.md`

검색은 공개이지만 캡처 제품 데이터 접근 권한을 주지는 않습니다. 어떤 지침을 받고 활성화하거나 설치할지는 클라이언트가 결정합니다. 마켓 목록은 패키지를 찾는 추가 경로이며 웹사이트, GitHub, MCP 직접 접근은 독립적으로 유지됩니다.

## 컨텍스트 및 사용량 {/* #context-and-usage */}

카탈로그에서 시작하고 현재 작업에 필요한 워크플로와 보조 파일만 로드하세요. 모든 스킬을 읽으면 에이전트 컨텍스트에 지침이 추가되어 모델 토큰 사용량이 늘 수 있습니다. 9개를 모두 설치해도 모두 동시에 활성화할 필요는 없습니다.

공개 검색, 다운로드 및 MCP 스킬 리소스 읽기는 Reconstruct 캡처 컨텍스트 읽기를 소비하지 않습니다. 스킬을 따르며 호출하는 캡처 도구에는 일반 [구독 한도 및 사용 규칙](/docs/ko/mcp-tools#usage-limits)이 적용됩니다. 모델 토큰 사용량은 AI 제공업체가 과금하거나 제한합니다.

## 업데이트 및 라이선스 {/* #updates-and-license */}

로컬 설치를 갱신하려면 선택한 소스의 설치 명령을 반복하거나 skills CLI 업데이트 명령을 사용하세요. 웹사이트 아카이브, GitHub 패키지 및 MCP 리소스는 별도 릴리스됩니다. 서버가 갱신되어도 로컬 사본은 자동 변경되지 않습니다. MCP 클라이언트는 리소스를 가져올 때 서버가 현재 제공하는 버전을 읽습니다.

Reconstruct AI Skills는 **MIT가 아닌 Cryptify 독점 라이선스**로 배포됩니다. Reconstruct와 함께 개인 또는 내부 업무용으로 사용할 수 있습니다. 재배포, 재판매 및 수정 버전 공개에는 Cryptify의 사전 서면 허가가 필요합니다. 전체 조건은 [Reconstruct AI Skills 라이선스](https://github.com/cryptify-corporation/reconstruct-ai-skills/blob/main/LICENSE)를 참고하세요.

웹사이트 아카이브에는 `LICENSE`와 `NOTICE`가 있습니다. `NOTICE`의 MIT 허가 고지는 Replica에서 변경한 출처 명시 제3자 자료에 적용되며 Reconstruct 패키지 전체의 라이선스가 아닙니다. 설치 사본과 함께 라이선스 및 저작자 표시 파일을 보관하세요.