# Handoff

> 代码交接文档 — 整理本项目已完成的全部设计文档、待办事项、已知风险、后续工作建议。设计阶段收尾、向实施团队或编码 skill 正式交接时调用本 skill 生成 HANDOVER.md。

- Skill: `blueprintos/handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add blueprintos/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blueprintos/handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: BlueprintOS (https://skillmd.com/u/blueprintos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blueprintos/handoff

---


# 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. 整理已完成文档

列出本项目已交付的设计文档:

```markdown
## 已完成文档

| 编号 | 文档 | 路径 | 状态 |
|---|---|---|---|
| 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 列出:

```markdown
## 待办事项

### P0(必须后续处理)
- [ ] ...

### P1(建议后续处理)
- [ ] ...

### P2(可选)
- [ ] ...
```

### 3. 整理已知风险与限制

```markdown
## 已知风险与限制

| 风险 | 影响 | 缓解 | 责任方 |
|---|---|---|---|
| ... | ... | ... | ... |
```

### 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 不受编号约束,严禁占位