AGENTS.md 审查
判定结果应用 agents-md 中的测试:需要多于一轮低成本反馈来发现和修复,并且不在任何技能或固定读取文件中声明。
验证,然后分类
审查提供的文件并声明其版本。 在评判之前,对照实际情况检查每个块;每个判定提供一条证据即可。
- 针对使用这些示例和格式的工具(变更日志生成器、发布工具、CI 工作流):错误。 阅读工具的配置就足够了;即使错误输出尚未发布,如果工具会错误地渲染,那就是错误的。
- 针对代码树和远程默认分支的列表:过时。
- 对照已合并 PR 的历史声称的约定:如果没有人在遵循,且维护者确认没有人决定过,则从未成为约定。 维护者可能有意引入规则,而人类提交者并不能证明是谁决定的,因此未遵循且维护者未裁定的规则应归入“人类决策”列表。
- 针对已安装技能和固定读取文件的规则:重复。
- 针对上述测试的所有其他内容:可发现、无内容或纯命令。
- 始终加载的指向长指南的指针:误放;它应属于需要它的技能。
一个块可能获得多个判定,每个判定都有各自的证据;优先使用不需要人工确认的判定,这样可以在维护者回复前开始修剪。
同时还要寻找缺失的内容:组织在其他地方应用的策略(意图文件规则、写作惯例、注释标记)、没有指针的非标准布局,以及没有同级 CLAUDE.md 符号链接的 AGENTS.md。
agents-md/references/before-after.md 是一个仓库的现成答案;针对你面前的仓库重新验证每一行,绝不要直接粘贴。
报告
| 块 | 判定 | 证据 |
|---|---|---|
| `Issue: #456`、`Issue: N/A` 作为有效页脚 | 错误,从未成为约定 | `cliff.toml` 将每个 `Issue:` 值转为 Jira 链接;维护者确认两者均未被决定 |
| 测试驱动 CLI 二进制文件,而非库;参见 `testsuite/AGENTS.md` | 保留 | 重做库级测试套件需要多于一轮反馈;没有技能声明这一点 |
然后提出修剪后的完整文件,列出移入技能或嵌套 AGENTS.md 的内容,以及需要人工决策的内容。
除非被要求,否则不要应用更改。