Deep Work 是一套结构化开发工作流技能,强调把思考与打字分开,在书面计划被审阅和批准之前绝不写代码。流程为:研究 → 规划 → 批注(可重复 1-6 次)→ 待办清单 → 实现 → 反馈,所有产物以 markdown 文件持久化在 .claude/ 目录(不是项目根目录)。
研究阶段:先深度阅读相关代码,要读目标区域的每个文件,包括实现、边界情况与错误处理,端到端追踪数据流,识别既有模式、约定、工具与缓存层,记录集成点,最后把详细报告写入 .claude/research.md。写完即停,用户确认研究准确后才进入规划。
规划阶段:基于真实代码库写详细实现计划到 .claude/plan.md,内容包括方法说明与理由、实际改动代码片段(非伪代码)、将修改或创建的文件路径、权衡考量、明确不改动的部分及原因。计划末尾须写 "Ready for your review. Add inline notes directly to .claude/plan.md and tell me when to address them.",此时不实现。
批注循环:用户在 plan.md 中直接加批注,用户说 "address my notes" 时需找出所有非原计划文本(更正、提问、覆盖、约束),逐条处理并删除批注文字本身,结尾写 "All notes addressed. Review again or say 'add the todo list' when satisfied." 仍不实现,循环直到用户明确批准。
待办清单:计划获批后向 .claude/plan.md 追加细粒度任务清单,按阶段分组的复选框,每个任务应小到能一步完成。仍等待用户确认再开始。
实现阶段:用户说 "implement" 或 "go" 后依序执行所有任务,每完成一项把 - [ ] 改为 - [x],直到全部完成;每个阶段后运行类型检查/代码检查。代码质量要求:不加不必要的注释或 jsdoc,不用 any 或 unknown 类型,严格遵循既有代码模式。
反馈阶段:实现中用户可给简短修正,如遗漏了某函数、迁移到某应用、调整宽度或间距、参照某表格样式;用户说已回滚时,需重读当前文件状态、收窄范围并按指定重新实现。另有 references/prompts.md 提供各阶段可复制使用的提示词。