How I Use Claude Code：深度研究、规划注释与单会话执行的工作流

本文介绍 Boris Tane 使用 Claude Code 的独特工作流程，区别于大多数开发者的使用方式。作者通过深度研究、详细规划和注释循环三个阶段，实现了高效的人机协作开发模式。

阶段一：深度研究

每个有意义的任务都从深度阅读指令开始。作者要求 Claude 在执行任何操作之前，彻底理解代码库的相关部分。并且始终要求将研究发现写入持久的 markdown 文件，而不是仅在聊天中提供口头摘要。

深度阅读这个文件夹，深入理解它的工作原理、功能以及所有细节。完成后，在 research.md 中撰写详细的学习和发现报告。

注意语言中的关键词："深入"、"详细"、"复杂性"、"全面检查"。这些不是空话——没有这些词，Claude 只会浅尝辄止。

书面成果（research.md）至关重要。这不是为了让 Claude 做作业，而是作者的审查界面。作者可以阅读它，验证 Claude 是否真正理解了系统，并在任何规划发生之前纠正误解。

阶段二：规划

审查完研究后，作者要求在一个单独的 markdown 文件中提供详细的实施计划。

我想构建一个名为 <名称和描述> 的新功能，扩展系统以实现 <业务结果>。撰写一份详细的 plan.md 文档，概述如何实施。包括代码片段。

生成的计划总是包括：方法的详细解释、显示实际更改的代码片段、将要修改的文件路径、考虑因素和权衡。

作者使用自己的 .md 计划文件，而不是 Claude Code 内置的计划模式。内置的计划模式不够好，而 markdown 文件让作者拥有完全的控制权。

一个经常使用的技巧： 对于封装良好的功能，如果在开源仓库中看到过好的实现，作者会分享该代码作为参考，连同计划请求一起提供。

注释循环

这是作者工作流程中最独特的部分，也是作者增加最多价值的部分。

Claude 写完计划后，作者会在编辑器中打开它，并直接在文档中添加内联注释。这些注释纠正假设、拒绝方法、添加约束，或提供 Claude 不具备的领域知识。

作者会添加的一些真实注释示例：

"使用 drizzle:generate 进行迁移，而不是原始 SQL" — Claude 不具备的领域知识
"不——这应该是 PATCH，不是 PUT" — 纠正错误的假设
"完全删除这一部分，我们这里不需要缓存" — 拒绝提议的方法

然后作者让 Claude 回到文档：

我在文档中添加了一些注释，请处理所有注释并相应地更新文档。先不要实施。

这个循环重复 1 到 6 次。 明确的 "先不要实施" 守卫至关重要。

为什么这个方法如此有效

markdown 文件充当作者和 Claude 之间的共享可变状态。作者可以按照自己的节奏思考，精确地注释哪里出了问题，并在不丢失上下文的情况下重新参与。

三轮 "我添加了注释，更新计划" 可以将一个通用的实施计划转变为完美契合现有系统的计划。

待办清单

在实施开始之前，作者总是要求提供细粒度的任务分解：

在计划中添加一个详细的待办清单，包含完成计划所需的所有阶段和单个任务——先不要实施。

阶段三：实施

当计划准备就绪时，作者发出实施命令：

全部实施。完成一个任务或阶段后，在计划文档中将其标记为已完成。不要停止，直到所有任务和阶段都完成。不要添加不必要的注释或 JSDoc，不要使用 any 或 unknown 类型。持续运行类型检查以确保没有引入新问题。

这个单一提示编码了所有重要的内容：

"全部实施"：执行计划中的所有内容，不要挑挑拣拣
"在计划文档中将其标记为已完成"：计划是进度的唯一真实来源
"不要停止，直到所有任务和阶段都完成"：不要中途暂停等待确认
"不要添加不必要的注释或 JSDoc"：保持代码整洁
"不要使用 any 或 unknown 类型"：保持严格类型
"持续运行类型检查"：尽早发现问题

作者希望实施过程是枯燥的。 创意工作发生在注释循环中。

实施期间的反馈

一旦 Claude 开始执行计划，作者的角色就从架构师转变为监督者。提示变得明显更短。

规划注释可能是一段话，而实施修正往往只有一句话：

"你没有实现 deduplicateByTitle 函数。"
"你把设置页面建在了主应用中，而它应该在 admin 应用中，移动它。"

前端工作是最具迭代性的部分。作者在浏览器中测试并快速发出修正：

"更宽一点"
"仍然被截断了"
"有 2px 的间隙"

当某个方向出错时，作者不会尝试修补它。而是通过丢弃 git 更改来恢复和重新确定范围：

我恢复了一切。现在我想要的只是让列表视图更简洁——别的什么都不做。

保持主导权

即使作者将执行委托给 Claude，也从不给予它对构建内容的完全自主权。作者在 plan.md 文档中完成了绝大部分的主动引导。

从提议中挑选： 当 Claude 识别出多个问题时，作者会逐一检查。

削减范围： 当计划包含锦上添花的功能时，作者会主动削减它们。

保护现有接口： 当作者知道某些东西不应该改变时，会设置硬性约束。

覆盖技术选择： 有时作者有 Claude 不会知道的特定偏好。

Claude 处理机械执行，而作者做出判断决策。

单一会话

作者在一个单一会话中运行研究、规划和实施，而不是将它们分散到不同的会话中。

作者没有看到大家在 50% 上下文窗口后谈论的性能下降。实际上，当作者说 "全部实施" 时，Claude 已经花了整个会话来建立理解。

一句话总结工作流程

深度阅读，撰写计划，注释计划直到正确，然后让 Claude 执行整个计划而不停止，同时检查类型。

就是这样。没有神奇的提示，没有复杂的系统指令，没有巧妙的技巧。只是一个将思考与打字分离的纪律严明的流程。