译：我的 AGENTS.md 文件

原文：https://www.aihero.dev/my-agents-md-file-for-building-plans-you-actually-read
作者：Matt Pocock

大多数开发者最初对 AI 代码生成持怀疑态度。似乎 AI 不可能像你一样理解你的代码库，或者匹配你多年经验积累下来的直觉。

但有一项技术改变了一切：规划循环（planning loop）。你不再是直接要求 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 或 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