我的 AGENTS.md：生成你真正愿意阅读的计划

大多数开发者起初都会怀疑 AI 代码生成。AI 似乎不可能像你一样理解代码库，也不可能具备你多年经验积累出的直觉。

但有一种方法会改变一切：规划循环。不要直接让 AI 编写代码，而是采用结构化循环，从而显著提高输出质量。

这种方式能把 AI 从不可靠的代码生成器，转变为不可或缺的编码伙伴。

规划循环：四步流程

现在，每一段代码都会经过相同的循环。

规划 ：先与 AI 一起规划。编写任何代码之前，共同思考实现方式，讨论策略，并就要构建的内容达成一致。

执行 ：让 AI 编写符合计划的代码。此时不是让它自行决定构建什么，因为你们已经共同明确了目标。

测试 ：共同测试代码。运行单元测试、检查类型安全或执行人工 QA，验证实现是否符合计划。

提交 代码，然后针对下一项工作重新开始循环。

为什么这很重要

想从 AI 获得可靠输出，这个循环不可或缺。

如果完全跳过规划步骤，就会给自己制造困难。你等于要求 AI 猜测你的意图，最终只会不断应对幻觉和误解。

规划会迫使目标变得清晰，让 AI 的工作更容易，也让代码更好。

创建优秀计划的规则

下面是我的 CLAUDE.md 文件中让 计划模式 真正有效的关键规则：

## Plan Mode

- Make the plan extremely concise. Sacrifice grammar for the sake of concision.
- At the end of each plan, give me a list of unresolved questions to answer, if any.

这些简单准则能把冗长计划转化为易浏览、可执行的文档，让你与 AI 始终保持一致。

把它们复制到 CLAUDE.md or AGENTS.md 文件中，即可获得更简单、更易读的计划。

或者运行以下脚本，把它们追加到 ~/.claude/CLAUDE.md 文件：

mkdir -p ~/.claude && cat >> ~/.claude/CLAUDE.md << 'EOF'

## Plan Mode

- Make the plan extremely concise. Sacrifice grammar for the sake of concision.
- At the end of each plan, give me a list of unresolved questions to answer, if any.
EOF