# Code2Skill

![Code2Skill：把现有代码变成 Agent 能力](docs/assets/code2skill-social-preview.png)

[English](README.md) | 简体中文

Code2Skill 是一组可安装的 Agent Skills。它帮助编程 Agent 从用户授权的前端、后端或全栈代码中理解业务功能，并生成可供其他 Agent 使用的 Function、MCP Tools、业务 Skills 和离线测试。

当前正式版本：[v1.2.0](https://github.com/leechen298/Code2Skill/releases/tag/v1.2.0)。

```text
现有代码
  ↓ Code2Skill
Function + MCP Tools + Skills + Tests
  ↓
Agent 逐步取得信息并完成用户目标
```

Function 和 MCP 提供业务能力，Skill 负责引导 Agent 使用这些能力。是否调用、如何补问、如何理解接口响应以及下一步做什么，由实际调用的 Agent 决定。

## 它会做什么

- 从源码中真实存在的业务调用入口生成能力：客户端功能以客户端/Consumer 实际触发的调用为主；没有客户端时，从用户指定的公开 API、RPC、Service、消息或任务入口开始，按需读取公开请求/响应/契约结构。
- 从用户指定的页面、目录或功能中识别可以独立完成的主要目标。
- 将字段来源、选中结果的跨 Tool 交接、请求组装和确定性的格式转换写入 Function。
- 为主要目标分别生成 Skill，并复用必要的 Function 和 MCP Tool。
- 默认只做离线技术验证，不主动调用真实业务接口。

## 可以用哪些 Agent

可以使用 Codex、Claude Code、Kimi Code 等主流编程 Agent 运行 Code2Skill。生成后的 Skill 可以安装到 Codex、Claude Code、Cursor、OpenClaw 等支持 Agent Skills 的环境。

更多环境见 [`skills` CLI 支持列表](https://github.com/vercel-labs/skills#supported-agents)。需要执行真实业务操作时，还需按照生成结果中的 `MCP-SETUP.md` 注册 MCP。

## 安装

使用通用 Agent Skills CLI 一次安装三个 Skill：

```bash
npx skills add leechen298/Code2Skill \
  --skill code2skill-generate code2skill-review-flow code2skill-review-source \
  --agent "$AGENT_ID" \
  --global \
  --yes
```

- [`code2skill-generate`](skills/code2skill-generate/references/SKILL.zh-CN.md)：生成 Function、MCP、业务 Skill 和离线测试。
- [`code2skill-review-flow`](skills/code2skill-review-flow/references/SKILL.zh-CN.md)：检查用户能否通过主要流程完成目标。
- [`code2skill-review-source`](skills/code2skill-review-source/references/SKILL.zh-CN.md)：深入检查请求字段、转换和调用链是否符合源码。

日常生成只需要 `code2skill-generate`，两个 Review Skill 按需独立使用。三个 Skill 的执行说明和默认生成文档模板均提供中英文版本，面向用户的产物跟随请求语言。可选的旧版 `strict-export-v1` 兼容模式仍输出 `zh-CN` 文档。旧版本迁移、生成结果的依赖安装和 MCP 注册见[安装说明](docs/installation.md)。

### DeepSeek Harness

DeepSeek Harness 用户可以把三个 Skill 作为 Bundle 安装到指定 profile：

```bash
dsh plugin --profile web add github:leechen298/Code2Skill#v1.2.0
```

安装、验证、headless profile 和卸载说明见 [DeepSeek Harness 集成文档](docs/deepseek-harness.md)。生成后的业务 MCP 仍按各产物的 `MCP-SETUP.md` 单独注册。

## 使用边界

Code2Skill 生成的是可运行、可继续修改的业务能力初稿，不自动证明所有业务规则或真实环境均已验证。生成模型、源码完整度和授权范围都可能影响结果。

对于复杂写入或高价值业务，建议使用方重点抽检：跨 Tool 数据来源、同名字段语义、确定性请求转换、目标自己的前置步骤、附件上传与下游绑定。需要时再使用 `code2skill-review-flow` 检查主流程，或使用 `code2skill-review-source` 核对关键源码语义；默认离线测试不替代真实接口和部署验收。

## 快速使用

在目标代码仓库中调用，并明确允许搜索的源码范围：

```text
使用 $code2skill-generate，把 <页面、目录、功能路径或公开入口> 生成为可运行的 Function、MCP 和 Skills。
允许搜索的源码根目录：<前端目录>、<后端目录>、<协议目录>、<Service/消息/任务目录>。
以源码中真实存在的业务调用入口为主要能力来源，不调用真实业务接口。
```

需要复核时：

```text
使用 $code2skill-review-flow，审核 <生成结果路径> 的主要目标是否能够完成。

使用 $code2skill-review-source，审核 <生成结果路径> 中 <指定 Skill 或能力> 与授权源码是否一致。
```

## 生成结果

默认产物的逻辑组成保持不变，具体扩展名、依赖清单和启动方式跟随目标技术栈的 runtime profile。当前 `core-export-v1` 默认格式由 `node-stdio` profile 实现：

```text
generated/code2skill/<feature-id>/
├── SKILL.md 或 skills/*/SKILL.md
├── function-core/index.mjs      # node-stdio profile 示例
├── mcp-tool/index.mjs           # node-stdio profile 示例
├── portable-agent-result.mjs    # HTTP 场景辅助库
├── tests/
├── package.json
├── MCP-SETUP.md
└── references/feature-context.md  # 复杂业务才生成
```

每个生成目录的 `MCP-SETUP.md` 会说明实际运行语言、依赖安装、启动方式、环境变量、未满足条件和 MCP 注册方法。Skill 已安装、MCP 已连接和真实业务已验证是三个独立状态。

## 生成效果参考

同一份匿名、多目标源码的三次生成记录：

| 生成模型/运行配置 | 生成日期 | 生成耗时 | 综合参考分 |
|---|---|---:|---:|
| GPT-5.6 Sol（Ultra 模式） | 2026-07-24 | 47 分 45 秒 | **9.4** |
| Kimi K3（Max 推理档位） | 2026-07-24 | 约 93 分钟 | **8.9** |
| GPT-5.6 Sol（High 推理档位） | 2026-07-24 | 20 分 29 秒 | **8.4** |

耗时统计到生成和当轮离线验证完成，不包含之后单独进行的评分、目录调整、安装或部署。评分方法、两套评分体系和隐私边界见[完整评估报告](docs/evaluation.md)。

## 文档

- [安装 Skill、生成结果依赖与注册 MCP](docs/installation.md)
- [生成结果的结构和设计原则](docs/generated-results.md)
- [调用方式与语言中立化迭代设计](docs/development/runtime-neutral-generation-v1.zh-CN.md)
- [业务工作流识别与 Tool 拆分设计](docs/development/workflow-aware-generation-v1.zh-CN.md)
- [可选的高级验证流程](docs/advanced-validation.md)
- [生成模型、评分方法与匿名评估结果](docs/evaluation.md)
- [完整文档索引](docs/README.md)

Skill 遵循 [Agent Skills specification](https://agentskills.io/specification)，安装使用 [vercel-labs/skills](https://github.com/vercel-labs/skills)。生成的 MCP 使用标准 stdio 或 Streamable HTTP 传输。