leechen298/Code2Skill

English | 简体中文

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

当前正式版本：v1.2.0。

现有代码
  ↓ 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 支持列表。需要执行真实业务操作时，还需按照生成结果中的 MCP-SETUP.md 注册 MCP。

安装

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

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

• code2skill-generate：生成 Function、MCP、业务 Skill 和离线测试。
• code2skill-review-flow：检查用户能否通过主要流程完成目标。
• code2skill-review-source：深入检查请求字段、转换和调用链是否符合源码。

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

DeepSeek Harness

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

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

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

使用边界

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

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

快速使用

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

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

需要复核时：

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

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

生成结果

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

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

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

文档

• 安装 Skill、生成结果依赖与注册 MCP
• 生成结果的结构和设计原则
• 调用方式与语言中立化迭代设计
• 业务工作流识别与 Tool 拆分设计
• 可选的高级验证流程
• 生成模型、评分方法与匿名评估结果
• 完整文档索引

Skill 遵循 Agent Skills specification，安装使用 vercel-labs/skills。生成的 MCP 使用标准 stdio 或 Streamable HTTP 传输。