08-25
AGENTS.md 瘦身指南：用渐进披露守住指令预算
AGENTS.md 是签入 Git 的 Markdown 文件，用于向 AI 编码代理注入仓库级指令，但它会在每次请求时全文加载，存在“指令预算”上限：前沿模型大约只能稳定遵循 150–200 条指令。文件越大越容易过时，过期路径或架构描述反而会污染上下文。本文主张把 AGENTS.md 压缩到最小：一句话项目描述、非 npm 的包管理器、非常规构建/typecheck 命令，其余内容通过渐进披露拆到 docs/ 子文件、子目录 AGENTS.md 或 agent skills，并给出一段可直接粘贴给代理的重构 prompt。适合在用 Claude Code 等代理工具、并希望控制 token 成本与指令混乱的工程团队。