交给 coding agent 的十行规则，写在它碰仓库之前
来源：dev.to — 2026-11-14
📋 概述
每个 coding agent 在改代码前都会先读仓库，而你能为这次阅读设定默认值的唯一地方就是指令文件——AGENTS.md、CLAUDE.md 或你所用工具的叫法。作者的完整文件很长，但真正起作用的是十行：说清这个仓库是什么、给出唯一能证明完成的验证命令、规定只跑当前步骤需要的最小命令集、列出绝不可改的路径、要求一次只做一个 ticket 并先写失败测试、只汇报 diff 与测试结果。
🔑 核心要点
- 范围宣言要具体到语言与形态，比如这是 Python 3.12 的日志核对命令行工具，不含 web 框架。
- 跑测试不是命令而是愿望，必须给出可复制的一行命令，并且快到能反复跑。
- 禁区清单要显式列出生成目录、密钥、锁文件和不属于你的发布说明。
- 先写测试看它失败、再写代码看它通过这一行，能把 agent 改造成 TDD 形状。
💡 金句
“Run the tests is not a command, it's a wish.”
译：跑一下测试不是一条命令，而是一个愿望。
👍 0
👎 0
← 返回 dev.to 首页