handofflisted

# Handoff Skill ## 目标 当任务需要从一个 Agent、会话或执行上下文切换到另一个上下文时，使用本技能。交接文档必须保留任务状态，同时让下一个上下文保持轻量、可执行。 本技能面向任务级交接。长会话时间存档仍由 `session-manager` 负责。 T-C06 handoff 使用双产物协议： - Markdown 是人可读交接文档。 - JSON 是面向 `AGENT_RESUME` 的 agent 可读交接文档。 - Artifact Bus 将 JSON payload 保存为 `kind: handoff`，coordinator 不需要解析 Markdown 也能恢复。 ## 模式 ### CREATE 在 `.agent/handoffs/` 下创建 Markdown 文件，命名格式为： ```text YYYYMMDD-HHMMSS-{short-focus}.md ``` 同时在旁边创建 JSON payload： ```text H-YYYYMMDD-HHMMSS-{short-focus}.json ``` 文件必须足够自包含，让新 Agent 能开始工作；但不得重复复制已有 plan、PRD、ADR、commit、diff、issue 或 API 文档中的内容。应通过路径、commit 或 URL 引用这些产物。 当 Artifact Bus 存在时，验证并发布 JSON payload： ```bash node .agent/handoffs/scripts/handoff-protocol.js validate --payload-file .agent/handoffs/H-YYYYMMDD-HHMMSS-focus.json node .agent/handoffs/scripts/handoff-protocol.js publish --payload-file .agent/handoffs/H-YYYYMMDD-HHMMSS-focus.json --markdown-path .agent/handoffs/YYYYMMDD-HHMMSS-focus.md --agent-id coordinator ``` ### RESUME 从人可读 handoff（`HUMAN_RESUME`）恢复时： 1. 先读取 `AGENTS.md` 和必需的 `.agent/rules/` 文件。 2. 读取 handoff 文档。 3. 默认只读取 handoff 引用的文件，除非代码搜索显示 handoff 已过期。 4. 执行前对比 handoff、`git status` 和当前代码。 5. 如果 handoff 与仓库状态冲突，以仓库状态为准，并报告冲突。 ### AGENT_RESUME 从 JSON 恢复时： 1. 先读取 `AGENTS.md` 和必需的 `.agent/rules/` 文件。 2. 运行 `node .agent/handoffs/scripts/handoff-protocol.js resume-prompt --payload-file <handoff.json>`。 3. 读取 `artifacts.context_snapshot_ref` 和被引用的 Artifact Bus 条目。 4. 如果 Progress Lock 可用，在写入前获取必要的 task/file locks。 5. 从 `task_pr