$npx -y skills add BlueprintOS/analysis-to-delivery --skill handoff代码交接文档 — 整理本项目已完成的全部设计文档、待办事项、已知风险、后续工作建议。设计阶段收尾、向实施团队或编码 skill 正式交接时调用本 skill 生成 HANDOVER.md。
| 1 | # Handoff — 代码交接 |
| 2 | |
| 3 | ## Contract |
| 4 | |
| 5 | - 输入: P0=0 的 QA 审计报告,已完成的全部设计文档,已知风险与待办 |
| 6 | - 输出: `HANDOVER.md` |
| 7 | - 门控: 交接文档含已完成文档清单、待办、风险、后续建议;接收方已确认收到 |
| 8 | - Required rules: `stage-gate`, `doc-numbering`, `context-pointer`, `goal-boundary` |
| 9 | - Required paths: `knowledge-path`, `tech-stack-path`, `compliance-path`, `doc-naming-path` |
| 10 | - 下一步: `/using-superpowers` 或交接给开发团队 |
| 11 | |
| 12 | ## 适用场景 |
| 13 | |
| 14 | - QA 审计通过(P0=0) |
| 15 | - 准备把设计交付给编码 skill(如 `wms-code-implementation`)或开发冲刺 |
| 16 | |
| 17 | ## 流程步骤 |
| 18 | |
| 19 | ### 1. 整理已完成文档 |
| 20 | |
| 21 | 列出本项目已交付的设计文档: |
| 22 | |
| 23 | ```markdown |
| 24 | ## 已完成文档 |
| 25 | |
| 26 | | 编号 | 文档 | 路径 | 状态 | |
| 27 | |---|---|---|---| |
| 28 | | 01 | 业务需求文档 BRD | `01-业务需求文档 BRD.md` | ✅ | |
| 29 | | 02 | 功能规格说明书 FSD | `02-功能规格说明书 FSD.md` | ✅ | |
| 30 | | 03 | 数据模型设计 | `03-数据模型设计.md` | ✅ | |
| 31 | | 04 | 合规评审 | `04-合规评审.md` | ✅ | |
| 32 | | 05 | 产品需求文档 PRD | `05-PRD.md` | ✅ | |
| 33 | | 06 | 开发设计说明书 | `06-开发设计说明书.md` | ✅ | |
| 34 | | 07 | 测试用例设计 | `07-测试用例设计.md` | ✅ | |
| 35 | | 08 | 设计回测报告 | `08-设计回测报告.md` | ✅ | |
| 36 | | 09 | QA 审计报告 | `09-QA审计报告.md` | ✅ | |
| 37 | | - | AGENTS.md | `AGENTS.md` | ✅ | |
| 38 | ``` |
| 39 | |
| 40 | ### 2. 整理待办事项 |
| 41 | |
| 42 | 按 P0/P1/P2 列出: |
| 43 | |
| 44 | ```markdown |
| 45 | ## 待办事项 |
| 46 | |
| 47 | ### P0(必须后续处理) |
| 48 | - [ ] ... |
| 49 | |
| 50 | ### P1(建议后续处理) |
| 51 | - [ ] ... |
| 52 | |
| 53 | ### P2(可选) |
| 54 | - [ ] ... |
| 55 | ``` |
| 56 | |
| 57 | ### 3. 整理已知风险与限制 |
| 58 | |
| 59 | ```markdown |
| 60 | ## 已知风险与限制 |
| 61 | |
| 62 | | 风险 | 影响 | 缓解 | 责任方 | |
| 63 | |---|---|---|---| |
| 64 | | ... | ... | ... | ... | |
| 65 | ``` |
| 66 | |
| 67 | ### 4. 后续工作建议 |
| 68 | |
| 69 | - **进入实施**:推荐 `/using-superpowers` 走 5 步实施子流程 |
| 70 | - **或转交编码 skill**:如 `wms-code-implementation` |
| 71 | - **或直接进入开发冲刺**:按 PRD §九 上线计划推进 |
| 72 | |
| 73 | ### 5. 触发 |
| 74 | |
| 75 | - 转交编码 skill → 在项目根放 `HANDOVER.md` |
| 76 | - 或直接进入开发冲刺 → 把 HANDOVER.md 链接发到团队群 |
| 77 | |
| 78 | ## 输出 |
| 79 | |
| 80 | - `HANDOVER.md` |
| 81 | |
| 82 | ## 调用的 rule |
| 83 | |
| 84 | - `rules/stage-gate` — 阶段 9 门控 |
| 85 | - `rules/doc-numbering` — HANDOVER 不受编号约束 |
| 86 | |
| 87 | ## 结束条件 |
| 88 | |
| 89 | - [ ] HANDOVER.md 含 4 节(已完成/待办/风险/后续) |
| 90 | - [ ] 接收方(编码 skill / 开发团队)已确认收到 |
| 91 | |
| 92 | ## 反模式 |
| 93 | |
| 94 | - ❌ HANDOVER 写"已交付" — 必须含 4 节(已完成/待办/风险/后续),缺一不可 |
| 95 | - ❌ 待办事项不给责任方 — 每条 TODO 必须有责任人 + 预期完成时间 |
| 96 | - ❌ 已知风险无缓解建议 — 每条风险必须配缓解 + 触发条件 |
| 97 | - ❌ 后续工作无优先级 — 必须分 P0/P1/P2,接收方才知道先做什么 |
| 98 | - ❌ 不写验收清单(已交付 vs 验收) — 必须含"接收方验收 Checklist" 段 |
| 99 | - ❌ HANDOVER 占编号(写 10-HANDOVER) — HANDOVER 不受编号约束,严禁占位 |