【让AI写代码更靠谱的秘诀：先规划，后记录，再验证】
用Claude Code开发功能时，很多人直接让它动手写代码，结果往往是代码越写越乱，新开一个会话又要从头解释一遍。
Drew Wilson分享了一套简单但极其有效的工作流：
第一步，永远让它先写计划再动手。这一步看似多余，实则关键。解释的过程会暴露它是否真正理解了你的需求，能在错误假设变成500行代码之前就把它拦住。
第二步，代码写完后让它更新一份命名清晰的文档。这份文档就是项目的长期记忆。没有它，每个新会话都要从零开始理解之前构建了什么。
第三步，让它验证文档和代码是否一致。双向校验，确保两边不会脱节。
之后每次让新的Agent完成任务，都要求它“更新相关文档”。文档命名得当的话，这套流程会像魔法一样顺滑。
有人担心文档太多会造成上下文膨胀。其实不需要让每个新Agent读完所有文档，只需要说“读取与你工作相关的文档”，它自己会找到对应的内容。
社区里还有几个补充技巧值得一提：
在文件开头用100行左右的注释写清文档说明，这样Agent读取文件时自动获得上下文，省去额外调用。
维护一个CHANGELOG，记录每次改了什么、为什么改。后续会话扫一眼就能快速上手，上下文成本极低。
在Claude.md里建一个简单索引，标注文件名和对应内容，帮助新会话精准拉取需要的文档。
还有一条容易被忽视：让它动手前先问清楚所有问题，不要自作主张做强假设。主动暴露信息缺口，比事后返工高效得多。
这套方法的本质是把AI当成需要交接文档的团队成员来管理。代码会过期，但好的文档能让知识持续流转。对人类团队成员来说，review和理解系统运作也会轻松很多。
看起来是“额外步骤”，实际上是在为未来的自己和团队省时间。
x.com/drewwilson/status/2017496985511858352
用Claude Code开发功能时，很多人直接让它动手写代码，结果往往是代码越写越乱，新开一个会话又要从头解释一遍。
Drew Wilson分享了一套简单但极其有效的工作流：
第一步，永远让它先写计划再动手。这一步看似多余，实则关键。解释的过程会暴露它是否真正理解了你的需求，能在错误假设变成500行代码之前就把它拦住。
第二步，代码写完后让它更新一份命名清晰的文档。这份文档就是项目的长期记忆。没有它，每个新会话都要从零开始理解之前构建了什么。
第三步，让它验证文档和代码是否一致。双向校验，确保两边不会脱节。
之后每次让新的Agent完成任务，都要求它“更新相关文档”。文档命名得当的话，这套流程会像魔法一样顺滑。
有人担心文档太多会造成上下文膨胀。其实不需要让每个新Agent读完所有文档，只需要说“读取与你工作相关的文档”，它自己会找到对应的内容。
社区里还有几个补充技巧值得一提：
在文件开头用100行左右的注释写清文档说明，这样Agent读取文件时自动获得上下文，省去额外调用。
维护一个CHANGELOG，记录每次改了什么、为什么改。后续会话扫一眼就能快速上手，上下文成本极低。
在Claude.md里建一个简单索引，标注文件名和对应内容，帮助新会话精准拉取需要的文档。
还有一条容易被忽视：让它动手前先问清楚所有问题，不要自作主张做强假设。主动暴露信息缺口，比事后返工高效得多。
这套方法的本质是把AI当成需要交接文档的团队成员来管理。代码会过期，但好的文档能让知识持续流转。对人类团队成员来说，review和理解系统运作也会轻松很多。
看起来是“额外步骤”，实际上是在为未来的自己和团队省时间。
x.com/drewwilson/status/2017496985511858352
