| name | handoff |
| description | 代码交接文档 — 整理本项目已完成的全部设计文档、待办事项、已知风险、后续工作建议。设计阶段收尾、向实施团队或编码 skill 正式交接时调用本 skill 生成 HANDOVER.md。 |
| disable-model-invocation | true |
| version | 4.0.0 |
| requires | ["stage-gate","doc-numbering"] |
Handoff — 代码交接
Contract
- 输入: P0=0 的 QA 审计报告,已完成的全部设计文档,已知风险与待办
- 输出:
HANDOVER.md
- 门控: 交接文档含已完成文档清单、待办、风险、后续建议;接收方已确认收到
- Required rules:
stage-gate, doc-numbering, context-pointer, goal-boundary
- Required paths:
knowledge-path, tech-stack-path, compliance-path, doc-naming-path
- 下一步:
/using-superpowers 或交接给开发团队
适用场景
- QA 审计通过(P0=0)
- 准备把设计交付给编码 skill(如
wms-code-implementation)或开发冲刺
流程步骤
1. 整理已完成文档
列出本项目已交付的设计文档:
## 已完成文档
| 编号 | 文档 | 路径 | 状态 |
|---|---|---|---|
| 01 | 业务需求文档 BRD | `01-业务需求文档 BRD.md` | ✅ |
| 02 | 功能规格说明书 FSD | `02-功能规格说明书 FSD.md` | ✅ |
| 03 | 数据模型设计 | `03-数据模型设计.md` | ✅ |
| 04 | 合规评审 | `04-合规评审.md` | ✅ |
| 05 | 产品需求文档 PRD | `05-PRD.md` | ✅ |
| 06 | 开发设计说明书 | `06-开发设计说明书.md` | ✅ |
| 07 | 测试用例设计 | `07-测试用例设计.md` | ✅ |
| 08 | 设计回测报告 | `08-设计回测报告.md` | ✅ |
| 09 | QA 审计报告 | `09-QA审计报告.md` | ✅ |
| - | AGENTS.md | `AGENTS.md` | ✅ |
2. 整理待办事项
按 P0/P1/P2 列出:
## 待办事项
### P0(必须后续处理)
- [ ] ...
### P1(建议后续处理)
- [ ] ...
### P2(可选)
- [ ] ...
3. 整理已知风险与限制
## 已知风险与限制
| 风险 | 影响 | 缓解 | 责任方 |
|---|---|---|---|
| ... | ... | ... | ... |
4. 后续工作建议
- 进入实施:推荐
/using-superpowers 走 5 步实施子流程
- 或转交编码 skill:如
wms-code-implementation
- 或直接进入开发冲刺:按 PRD §九 上线计划推进
5. 触发
- 转交编码 skill → 在项目根放
HANDOVER.md
- 或直接进入开发冲刺 → 把 HANDOVER.md 链接发到团队群
输出
调用的 rule
rules/stage-gate — 阶段 9 门控rules/doc-numbering — HANDOVER 不受编号约束
结束条件
反模式
- ❌ HANDOVER 写"已交付" — 必须含 4 节(已完成/待办/风险/后续),缺一不可
- ❌ 待办事项不给责任方 — 每条 TODO 必须有责任人 + 预期完成时间
- ❌ 已知风险无缓解建议 — 每条风险必须配缓解 + 触发条件
- ❌ 后续工作无优先级 — 必须分 P0/P1/P2,接收方才知道先做什么
- ❌ 不写验收清单(已交付 vs 验收) — 必须含"接收方验收 Checklist" 段
- ❌ HANDOVER 占编号(写 10-HANDOVER) — HANDOVER 不受编号约束,严禁占位
