resume-handoff

根据交接文档继续工作

你需要通过交互流程，根据一份交接文档继续工作。这些交接文档包含此前工作会话中的关键信息、经验和后续步骤，需要理解并接续处理。

初始响应

调用此命令时：

1. 如果提供了交接文档路径：

   • 如果将交接文档路径作为参数提供，请跳过默认消息
   • 立即完整读取交接文档
   • 立即读取文档中链接到 thoughts/shared/plans 或 thoughts/shared/research 下的任何研究或计划文档。请勿使用子 Agent 读取这些关键文件。
   • 通过吸收交接文档中的相关上下文并读取其中提及的其他文件，开始分析
   • 然后向用户提出行动方案并征求确认，或询问需要澄清的方向

2. 如果提供了工单编号（如 ENG-XXXX）：

   • 查找该工单最新的交接文档。工单文件位于 thoughts/shared/handoffs/ENG-XXXX 中，其中 ENG-XXXX 是工单编号。例如，ENG-2124 的交接文档位于 thoughts/shared/handoffs/ENG-2124/。列出此目录的内容。
   • 目录中可能有零个、一个或多个文件。
   • 如果目录中没有文件，或目录不存在：告知用户：“抱歉，我似乎找不到该交接文档。请提供文档路径。”
   • 如果目录中只有一个文件：使用该交接文档继续
   • 如果目录中有多个文件：根据文件名中的日期和时间（格式为 YYYY-MM-DD_HH-MM-SS，采用 24 小时制），使用_最新的_交接文档。
   • 立即完整读取交接文档
   • 立即读取文档中链接到 thoughts/shared/plans 或 thoughts/shared/research 下的任何研究或计划文档；请勿使用子 Agent 读取这些关键文件。
   • 通过吸收交接文档中的相关上下文并读取其中提及的其他文件，开始分析
   • 然后向用户提出行动方案并征求确认，或询问需要澄清的方向

3. 如果未提供任何参数，请回复：

I'll help you resume work from a handoff document. Let me find the available handoffs.

Which handoff would you like to resume from?

Tip: You can invoke this command directly with a handoff path: `/resume_handoff `thoughts/shared/handoffs/ENG-XXXX/YYYY-MM-DD_HH-MM-SS_ENG-XXXX_description.md`

or using a ticket number to resume from the most recent handoff for that ticket: `/resume_handoff ENG-XXXX`

然后等待用户输入。

流程步骤

步骤 1：阅读并分析交接文档

1. 完整阅读交接文档：

   • 使用 Read 工具，且不要使用 limit/offset 参数
   • 提取所有章节：
     • 任务及其状态
     • 最近的更改
     • 经验
     • 产物
     • 待办事项和后续步骤
     • 其他备注

2. 启动有针对性的研究任务： 根据交接文档内容，并行启动研究任务以核实当前状态：

   Task 1 - Gather artifact context:
   Read all artifacts mentioned in the handoff.
   1. Read feature documents listed in "Artifacts"
   2. Read implementation plans referenced
   3. Read any research documents mentioned
   4. Extract key requirements and decisions
   Use tools: Read
   Return: Summary of artifact contents and key decisions
   

3. 等待所有子任务完成后再继续

4. 读取关键文件：

   • 完整读取“经验”部分中提到的文件
   • 阅读“最近的更改”中提到的文件，以了解相关修改
   • 阅读研究过程中发现的任何新相关文件

步骤 2：综合并呈现分析

1. 全面呈现分析：

   I've analyzed the handoff from [date] by [researcher]. Here's the current situation:
   
   **Original Tasks:**
   - [Task 1]: [Status from handoff] → [Current verification]
   - [Task 2]: [Status from handoff] → [Current verification]
   
   **Key Learnings Validated:**
   - [Learning with file:line reference] - [Still valid/Changed]
   - [Pattern discovered] - [Still applicable/Modified]
   
   **Recent Changes Status:**
   - [Change 1] - [Verified present/Missing/Modified]
   - [Change 2] - [Verified present/Missing/Modified]
   
   **Artifacts Reviewed:**
   - [Document 1]: [Key takeaway]
   - [Document 2]: [Key takeaway]
   
   **Recommended Next Actions:**
   Based on the handoff's action items and current state:
   1. [Most logical next step based on handoff]
   2. [Second priority action]
   3. [Additional tasks discovered]
   
   **Potential Issues Identified:**
   - [Any conflicts or regressions found]
   - [Missing dependencies or broken code]
   
   Shall I proceed with [recommended action 1], or would you like to adjust the approach?
   

2. 继续之前先获得确认

步骤 3：制定行动计划

1. 使用 TodoWrite 创建任务列表：

   • 将交接文档中的待办事项转换为待办任务
   • 添加分析过程中发现的任何新任务
   • 根据依赖关系和交接文档中的指导确定优先级

2. 呈现计划：

   I've created a task list based on the handoff and current analysis:
   
   [Show todo list]
   
   Ready to begin with the first task: [task description]?
   

步骤 4：转交给专业 Agent

重要：切勿直接实现。始终通过 Task 工具启动 Agent。

1. 分析任务类型并选择专业 Agent：

   负责人（可以启动工作 Agent）：

   Agent	领域	用途
   kraken	实现	大型功能、新系统、主要组件
   architect	规划	功能设计、系统架构、实现规划
   phoenix	规划	重构计划、迁移、代码库结构调整
   herald	部署	发布、部署、发布内容
   maestro	编排	复杂的多 Agent 工作流

   工作 Agent（专注于特定领域）：

   Agent	领域	用途
   spark	实现	快速修复、补丁、细微调整
   scribe	文档	文档、指南、说明
   sleuth	调试	Bug 调查、追踪、根因分析
   aegis	调试	安全审计、漏洞扫描
   profiler	调试	性能优化、瓶颈分析
   arbiter	验证	单元测试
   atlas	验证	端到端/集成测试
   oracle	研究	外部文档、最佳实践、操作指南
   scout	研究	代码库探索、查找现有代码
   pathfinder	研究	仓库结构分析
   plan-reviewer	审查	功能计划审查、设计验证
   plan-reviewer	审查	迁移审查、重构验证
   chronicler	会话	会话分析、历史摘要

2. 通过 Task 工具启动专业 Agent：

   Use Task tool with:
   - subagent_type: [selected agent from above]
   - prompt: [task description + relevant handoff context + learnings]
   

3. 在提示词中包含交接上下文：

   • 交接中的关键经验
   • 包含行号的文件引用
   • 应遵循的模式
   • 应避免的陷阱

4. 等待 Agent 完成，然后继续下一个任务

指南

1. 彻底分析：

   • 首先阅读完整的交接文档
   • 验证所有提及的更改仍然存在
   • 检查是否存在回归或冲突
   • 阅读所有引用的材料

2. 保持互动：

   • 开始工作前先展示调查结果
   • 就处理方案征求认同
   • 允许调整方向
   • 根据当前状态与交接时状态的差异灵活调整

3. 借鉴交接经验：

   • 特别关注“经验”部分
   • 运用记录的模式和方法
   • 避免重犯已提及的错误
   • 基于已发现的解决方案继续推进

4. 保持连续性：

   • 使用 TodoWrite 保持任务连续性
   • 在提交中引用交接文档
   • 记录与原计划的任何偏差
   • 完成后考虑创建新的交接文档

5. 行动前验证：

   • 切勿假设交接时的状态与当前状态一致
   • 验证所有文件引用仍然有效
   • 检查交接后是否发生破坏性更改
   • 确认相关模式仍然适用

常见场景

场景 1：顺利继续

• 交接中的所有更改均已存在
• 没有冲突或回归
• 后续行动项清晰明确
• 按建议的行动继续

场景 2：代码库已发生变化

• 部分更改缺失或已修改
• 交接后新增了相关代码
• 需要协调差异
• 根据当前状态调整计划

场景 3：交接工作未完成

• 交接中有任务标记为“in_progress”
• 需要先完成未完成的工作
• 可能需要重新理解部分实现
• 专注于完成现有工作，再开始新任务

场景 4：交接内容已过时

• 已经过了很长时间
• 已发生重大重构
• 原方案可能不再适用
• 需要重新评估策略

示例交互流程

User: /resume_handoff specification/feature/handoffs/handoff-0.md
Assistant: Let me read and analyze that handoff document...

[Reads handoff completely]
[Spawns research tasks]
[Waits for completion]
[Reads identified files]

I've analyzed the handoff from [date]. Here's the current situation...

[Presents analysis]

Shall I proceed with implementing the webhook validation fix, or would you like to adjust the approach?

User: Yes, proceed with the webhook validation
Assistant: This is a bugfix task, so I'll route to the `spark` agent.

[Uses Task tool with subagent_type="spark" and prompt containing:
 - The webhook validation fix task
 - Key learnings from handoff
 - Relevant file:line references
 - Patterns to follow]

[Waits for spark agent to complete]

The spark agent has completed the webhook validation fix. Moving to the next task...