Handover
Handover
写到项目根 .handoff 下的 latest.md。只写 delta;roadmap、plan、ADR、diff 用路径引用,不复制。 目标 ≤150 行。超过时把细节外置成链接,不把 handover 写成流水账。
handover_version: 1
created_at: <ISO-8601>
project: <project-name>
repo_root: <absolute-path>
branch: <branch>
head: <short-sha>
dirty: <true|false>
predecessor: <agent/model/session>
next_session_focus: <一句话,说明下一次接手要完成什么>
secrets_redacted: true
Objective
这次工作要达成什么;完成定义是什么。
State
当前状态一段话:已经走到哪、什么是确定的、什么还没确定。
Done
只列真的完成、且有证据的项。没有证据的写进 In Progress 或 Open Questions。
- <事项> — evidence: <commit / file:line / 测试输出 / 产物路径>
In Progress
- <半成品> — 停在:<具体位置>;下一步:<具体动作>
Next Action
只写一个。带文件、命令或明确动作。
<one exact next action>
Decisions
只写对话里做出、别处没有记录的决策。
- Decision:
- Why:
- Rejected:
- Revisit if:
Open Questions
需要用户或下一次接手决定的问题。保留原始措辞。
-
— owner: <user|next agent>; blocking: <yes|no>
Risks / Gotchas
- <坑或风险> — 触发条件:<...>;规避:<...>
Files
机械列出,不靠回忆。
- Read:
- Modified:
Verify
- Command:
- Last result: <pass|fail|not-run + 关键输出>
- At:
- Full gate: <path to CI / project gate, if any>
References
—
Do Not Redo
- <已经做过且不需要重做的事项> — evidence: <...>
Suggested Skills
—
Handover Chain
- Previous:
- Next session focus: <same as header, restated if useful>