本 skill 是一个路由型入口，本身不执行具体动作，仅负责告知 AI Agent：在当前项目状态下，应该调用以下哪一个子 skill。
docs/、vault/、项目备忘录.skill。> 拿不准当前该用哪个？直接丢本入口 SKILL，按下方"路由规则"自动判断阶段。
本套件包含四个相互衔接的子 skill，覆盖项目从无到有、从开发到变更、以及遗留代码接入的完整生命周期：
| 子 skill | 适用阶段 | 核心职责 |
|---|---|---|
| --- | --- | --- |
项目初始化 | 空白文件夹 → 规划完成 | 主动追问需求，生成 docs/、vault/、项目备忘录.skill 等规划文档 |
遗留项目接入 | 已有源码但缺脚手架 → 接入完成 | 逆向扫描现有代码，补齐 docs/、vault/、项目备忘录.skill，使其可被《项目开发》驱动 |
项目开发 | 规划完成 → 编码实现 | 按多 Agent 调度流程（编写→审查→测试→修复）迭代开发各模块 |
需求修改 | 开发途中 → 需求变更 | 批量评估变更影响，同步修改需求/架构/接口/任务/进度等文档 |
项目初始化 的条件docs/、vault/、项目备忘录.skill 均不存在。遗留项目接入 的条件docs/、vault/、项目备忘录.skill 至少有一项缺失或不完整（即项目并非由本套件初始化生成）。项目开发 的条件项目备忘录.skill 已存在（行数应控制在 200 行左右，略超不阻塞触发，仅提示精简）。docs/开发进度.md 存在并已标记"阶段四复核已完成"。vault/ 下存在可执行的模块任务文件。需求修改 的条件项目初始化 或 遗留项目接入 不得直接进入 项目开发；遗留代码库缺脚手架时必须先走 遗留项目接入，再进入 项目开发；开发途中变更需求必须先走 需求修改，再继续 项目开发。项目开发。./
├── SKILL.md # 本文件：路由入口
├── 项目初始化/
│ └── SKILL.md # 阶段一~四：需求确认 → 架构设计 → 开发规划 → 规划复核
├── 遗留项目接入/
│ └── SKILL.md # 阶段一~五：勘探 → 代码扫描 → 逆向生成脚手架 → 交叉校验 → 复核交接
├── 项目开发/
│ └── SKILL.md # 多 Agent 调度：编写 → 审查 → 测试 → 修复（≤3 轮）→ 提交
└── 需求修改/
└── SKILL.md # 阶段一~四：变更澄清 → 影响评估 → 批量修改 → 复核交接
下列示例用于帮助主 Agent 识别用户意图，并映射到对应的子 skill。识别时以关键词 + 当前目录状态双重判断为准。
项目初始化 的典型话术遗留项目接入 的典型话术项目开发 的典型话术vault/ 里的任务继续开发。"docs/开发进度.md。"需求修改 的典型话术| 现象 | 正确做法 |
|---|---|
| --- | --- |
| 工作目录为空，却直接被要求"实现登录模块" | 先调用 项目初始化 补齐规划文档，再进入 项目开发 |
| 仓库已有源码但无 vault/备忘录，却直接被要求"继续开发" | 先调用 遗留项目接入 逆向补齐脚手架文档，再进入 项目开发 |
| 开发到一半用户提出新功能，Agent 直接改代码 | 暂停编码，调用 需求修改 同步文档，复核通过后再回到 项目开发 |
| 用户只说"继续"，无法判断阶段 | 检查 docs/、vault/、项目备忘录.skill 状态后回复用户当前所处阶段，并确认下一步动作 |
| 多个子 skill 看似都适用 | 以"是否需要变更已确认的需求/架构"为优先判据：需要 → 需求修改；否则按目录状态选 项目初始化 或 项目开发 |
| 子 agent 因超时/断流/异常退出未交付交接单，主 Agent 自己顶替改业务代码、代写交接单 | 严禁由主 Agent 接管，必须按原角色 spawn 一个全新的子 agent 继续；主 Agent 仅在收尾中枢文件、汇总报告、裁决升级等自身职责内亲自处理 |
项目初始化 的需求确认阶段由用户与 Agent 协商决定。docs/ 与 vault/，项目备忘录.skill 仅保留索引与关键约束（目标 < 200 行；略超不阻塞，仅提示后续精简）。本套件假设项目由本套件从零初始化，并以 docs/、vault/、项目备忘录.skill 作为唯一上下文来源。其中接入已有遗留代码库的场景由《遗留项目接入.skill》专门覆盖。以下场景不在能力范围内，需用户额外介入或手动适配：
共 12 个版本