# Reconstruct 技能 {/* #reconstruct-skills */}

Reconstruct 技能为 AI 代理提供聚焦于产品任务的工作流程。每个技能包含说明，必要时还包含辅助模板。选择与工作相关的技能；使用其中一个不会自动运行整个产品生命周期。

九种工作流程可通过已连接 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 安装提供相同名称的九种工作流程。对同一代理请仅从一个来源安装，以免重复注册技能。在各自版本发布之前，版本可能存在差异。

## 通过 MCP 读取技能 {/* #read-skills-through-mcp */}

使用 Streamable HTTP 以及 OAuth 或个人 MCP 令牌，将代理连接至 **`https://reconstruct.dev/mcp`**。客户端专用设置请参阅[连接 AI 代理](/docs/zh/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
```

将全部九种工作流程安装到 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/zh/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，或将全部九种安装到 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/zh/connect-ai-agents)以获取采集证据。

## 手动安装 {/* #manual-installation */}

1. 下载[完整技能包](https://reconstruct.dev/downloads/reconstruct-skills.zip)。
2. 解压归档，并在 `skills/` 下选择所需文件夹。
3. 将这些文件夹复制到代理支持的技能目录。安装的分发内容应保留包中的 LICENSE 和 NOTICE。
4. 如果客户端需要，重新加载代理技能。

完整包包含九种工作流程及模板。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/zh/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 */}

先从目录开始，只加载当前任务需要的工作流程和辅助文件。读取所有技能会向代理上下文添加说明，可能增加模型令牌用量。安装全部九种不表示必须同时激活全部九种。

公开发现、下载和 MCP 技能资源读取不消耗 Reconstruct 采集上下文读取。遵循技能时调用采集工具，仍遵守正常[订阅限制和用量规则](/docs/zh/mcp-tools#usage-limits)。模型令牌用量由 AI 提供方计费或限制。

## 更新和许可证 {/* #updates-and-license */}

刷新本地安装时，重复所选来源的安装命令，或使用 skills CLI 更新命令。网站归档、GitHub 包和 MCP 资源独立发布；服务器更新时，本地安装副本不会自动更改。MCP 客户端获取资源时，读取服务器当前公开的版本。

Reconstruct AI Skills 按 Cryptify 的**专有许可证而非 MIT** 分发。许可证允许配合 Reconstruct 进行个人或企业内部使用。再分发、转售和发布修改版本需要事先取得 Cryptify 书面许可。完整条款参阅 [Reconstruct AI Skills 许可证](https://github.com/cryptify-corporation/reconstruct-ai-skills/blob/main/LICENSE)。

网站归档包含 `LICENSE` 和 `NOTICE`。`NOTICE` 中的 MIT 授权声明仅适用于从 Replica 改编并注明来源的第三方材料，并非整个 Reconstruct 包的许可证。请在安装副本中保留许可证和署名文件。