Handoff 填充指南与示例
本文说明 /handoff 到底应该交付什么，以及前端、后端和跨角色场景下的 handoff 应该怎样写才够用。
1. handoff 的目标
handoff 不是重复 diff，而是让下一角色能直接接住结果。
至少应回答：
- 改了什么
- 验证了什么
- 还剩什么风险
- 下一角色要关注什么
2. 最小字段
- 代码变更摘要
- 自测范围与证据
- 剩余风险
- QA 关注点
- 若命中 custom overlay，则补装配或执行记录
3. 后端 API 示例
text
代码变更摘要：新增审批记录查询接口，支持分页、状态筛选和权限校验
自测范围：单测通过，集成测试覆盖正常、无权限和空结果场景
剩余风险：历史状态枚举兼容性待联调确认
QA 关注点：极端分页参数、无权限访问、错误码一致性4. 前端页面示例
text
代码变更摘要：新增审批记录列表页与筛选表单
自测范围：已验证桌面、iPad、移动端布局和空态/错误态
剩余风险：极长审批标题场景待真实数据验证
QA 关注点：断点切换、键盘可达性、无结果空态5. 跨角色示例
如果一次交接同时包含前后端结果，建议分块写，不要混成一段模糊总结。
6. custom overlay 场景
如果启用了 custom overlay，handoff 里还应写：
- 启用了什么能力
- 为什么启用
- 做了什么
- 哪些约束需要 QA 或 release 继续核对
7. 常见错误
- 只有“已完成开发”
- 没有验证证据
- 没写剩余风险
- custom overlay 用了却没留下记录
如果你要看 handoff 在完整链路里的位置，继续看 first-team-workflow-walkthrough.md。