real-work

Real Work

将规划转化为可持久保存、可恢复的产物。计划文件才是事实来源，而不是 对话：它会记录要做什么、已完成什么、如何验证，以及如何部署。任何未来的 Agent 都可以在完全没有先前上下文的情况下从中继续。

适用场景：规划可能超出当前会话、包含多个步骤或多个会话的工作。简单的单次会话任务无需使用。

1. 先全面理解

在完全弄清范围之前，不要编写计划。持续向用户提问，直到你们双方都充分理解， 没有任何遗漏——把未提的问题视为未来的 bug。

• 不要在第一轮提问后就停止；持续追问，直到没有歧义、假设或待决定事项。深入探查边界：范围界定（包含／排除）、依赖项、约束、成功标准、数据、环境、部署、失败情形。
• 向用户明确提出每个假设并征求确认。如果某个回答引出新的未知事项，就继续追问——递归深入。
• 使用 AskUserQuestion 提出具体选项。完成后，向用户完整总结范围，只有在用户确认没有遗漏后才继续。

2. 编写计划

保存到仓库根目录下的 plans/<descriptive-name>.md（如有需要，创建 plans/）。使用以下可自我说明的模板：

# <Work Title>

<1-2 sentence goal and scope.>

## For Future Agents
As work proceeds: mark checkboxes `- [x]` as items complete; when a phase is done,
set its status to `Complete` and write its **Phase Summary** (what was done, key
decisions, anything needed to continue with zero context); run the phase's
**Verification Plan** and record the result before moving on. When all phases are
done, fill in **Final Recap** and **Deployment Plan**.

## Phase 1: <Title>
Status: Not started   

- [ ] <concrete, actionable item>
- [ ] <concrete, actionable item>

### Verification Plan
- <command/check the agent can run autonomously, with expected result>

### Phase Summary
_(write when phase completes)_

## Phase 2: <Title>
Status: Not started
- [ ] <actionable item>
### Verification Plan
- <autonomous check>
### Phase Summary
_(write when phase completes)_

## Final Recap
_(write when all phases complete: summary of the entire piece of work)_

## Deployment Plan
_(write when all phases complete: step-by-step deployment instructions)_

常见错误

• 事项含糊——每个复选框都应是一项具体任务（例如“为 PaymentClient.Charge 添加重试逻辑”），而不是一个主题（例如“改进支付”）。
• 验证方式无法自动执行——提供可运行的命令和预期输出，而不是“手动测试”。
• 保存位置错误——始终使用仓库根目录下的 plans/ 文件夹。
• 提前填写摘要——阶段摘要、回顾和部署计划都应保留为占位内容，直到相关工作实际完成。