/handoff

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 链接发到团队群

输出

• `HANDOVER.md`

调用的 rule

• `rules/stage-gate` — 阶段 9 门控
• `rules/doc-numbering` — HANDOVER 不受编号约束

结束条件

• [ ] HANDOVER.md 含 4 节(已完成/待办/风险/后续)
• [ ] 接收方(编码 skill / 开发团队)已确认收到

反模式

• ❌ HANDOVER 写"已交付" — 必须含 4 节(已完成/待办/风险/后续),缺一不可
• ❌ 待办事项不给责任方 — 每条 TODO 必须有责任人 + 预期完成时间
• ❌ 已知风险无缓解建议 — 每条风险必须配缓解 + 触发条件
• ❌ 后续工作无优先级 — 必须分 P0/P1/P2,接收方才知道先做什么
• ❌ 不写验收清单(已交付 vs 验收) — 必须含"接收方验收 Checklist" 段
• ❌ HANDOVER 占编号(写 10-HANDOVER) — HANDOVER 不受编号约束,严禁占位