聚水潭
118.20M · 2026-03-13
在审查并批准书面计划之前，绝不让 Claude 编写代码。 将规划与执行分离，可以避免无效劳动，保持对架构决策的控制权，并以更少的 token 消耗获得更好的结果。
Research → Plan → Annotate（重复1-6次）→ Todo List → Implement → Feedback & Iterate
每个有意义的任务都从深度阅读代码库开始。要求 Claude 在执行任何操作前，先彻底理解相关代码，并将调研结果写入持久化的 markdown 文件（如 research.md），而非仅在对话中口头总结。
关键技巧：
research.md 是审查面——用于验证 Claude 是否真正理解了系统，并在规划开始前纠正误解示例 prompt：
审查调研结果后，要求 Claude 在单独的 markdown 文件中编写详细的实施计划。计划应包含：方法说明、代码片段、需修改的文件路径、考量与权衡。
关键技巧：
.md 文件而非 Claude Code 内置的 plan mode，因为 markdown 文件可在编辑器中自由编辑、添加批注，并作为项目中的真实产物持久保存示例 prompt：
这是整个工作流中最具特色的环节。
plan.md批注内容示例：
use drizzle:generate for migrations, not raw SQL —— 补充 Claude 不具备的领域知识no — this should be a PATCH, not a PUT —— 纠正错误假设remove this section entirely, we don't need caching here —— 否决某个方案the queue consumer already handles retries, so this retry logic is redundant —— 解释变更原因this is wrong, the visibility field needs to be on the list itself, not on individual items —— 重新定向计划的某个章节关键约束： 每次让 Claude 处理批注时，必须明确加上 "don't implement yet"，否则 Claude 会在自认计划足够好时直接跳到编码阶段。
为什么有效：
实施前，要求生成粒度化的任务分解，作为实施过程中的进度追踪器。Claude 在执行时逐项标记完成状态，便于随时查看进展。
使用标准化的实施 prompt：
此 prompt 编码了以下要求：
| 指令 | 含义 |
|---|---|
implement it all | 执行计划中的所有内容，不要挑选 |
mark it as completed in the plan document | 计划文档是进度的唯一真实来源 |
do not stop until all tasks and phases are completed | 不要中途暂停等待确认 |
do not add unnecessary comments or jsdocs | 保持代码整洁 |
do not use any or unknown types | 维持严格类型 |
continuously run typecheck | 尽早发现问题 |
核心理念： 实施阶段应该是机械性的、无趣的。创造性工作已在批注循环中完成。计划确定后，执行应当简单直接。
实施开始后，开发者的角色从架构师转为监督者，指令变得极为简短：
You didn't implement the deduplicateByTitle function.You built the settings page in the main app when it should be in the admin app, move it.wider / still cropped / there's a 2px gapthis table should look exactly like the users table, same header, same pagination, same row density.虽然执行委托给 Claude，但绝不给予其对构建内容的完全自主权。主要的引导工作在 plan.md 中完成。
具体策略：
将调研、规划和实施放在同一个长会话中运行，而非拆分为多个独立会话。到发出"implement it all"时，Claude 已在整个会话中积累了充分理解。上下文窗口填满时，Claude 的自动压缩机制会保留足够的上下文继续工作，而计划文档作为持久化产物可以随时被引用。
深度阅读，编写计划，反复批注直到计划正确，然后让 Claude 不间断地执行全部内容，过程中持续检查类型。
没有魔法 prompt，没有复杂的系统指令，只是一条纪律严明的流水线——三思而后行。
