Harbor 对 GitHub 公开仓库中的 AI 编程规则文件开展检查,发现文件放进仓库后,指令未必能送达智能体。该团队于 2026 年 10 月 18 日抽取 3,905 个 CLAUDE.md 和 AGENTS.md 文件,使用其免费规则文件检查器逐一检查。据 Harbor 的加权估计,在根目录同时保留两份文件的仓库中,16% 的 CLAUDE.md 完全没有提及 AGENTS.md,导致后者未被 Claude Code 加载。
Harbor 援引 Anthropic 的记忆文档称,当启动目录或其上级目录中存在 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md 时,Claude Code 默认只读取相应的 CLAUDE.md 文件,不会自动加载 AGENTS.md。
研究发现,根目录中的 AGENTS.md 有 36% 旁边还放着 CLAUDE.md,抽样共得到 745 个成对仓库。按 Harbor 的加权统计,25% 通过 @AGENTS.md 导入,23% 将 CLAUDE.md 设为指向 AGENTS.md 的软链接,两种方式都能让内容送达 Claude。
另有 15% 只用一句话要求 Claude 阅读 AGENTS.md。Harbor 指出,这属于普通文字,只有 Claude 自行决定打开文件时才生效;还有 7% 的文件对由复制而来,随后分别修改,规则出现分歧。对于完全未提及 AGENTS.md 的 16%,研究也说明,部分仓库是有意为不同智能体分别维护规则。
Harbor 给出的修复方法是:在 CLAUDE.md 顶部单独一行写入 @AGENTS.md,再将 Claude 专用内容放在下方。软链接同样可用,但其援引 Anthropic 的提醒称,Windows 克隆未开启 core.symlinks 时,链接会被检出为一行文本。
据 Harbor 统计,CLAUDE.md 的行数中位数为 81 行,19% 超过 Anthropic 建议的 200 行,4% 超过 500 行。AGENTS.md 的中位数为 63 行,18% 超过 200 行。
字节上限则会影响内容能否完整进入模型。Harbor 引用 GitHub 的统计称,约 30,080 个 AGENTS.md 超过 32 KiB,占总数的 2.6%。据该研究介绍,Codex 会从根目录向下合并 AGENTS.md,默认在达到 project_doc_max_bytes 规定的 32 KiB 上限时停止追加,剩余内容不会进入模型。Harbor 自测中,终端没有给出提示;用户可缩减文件,或在 ~/.codex/config.toml 中调高上限。
Harbor 强调,研究仅覆盖公开仓库,不含 fork,反映的是 GitHub 在采样日期索引的文件状态。搜索排序与估算计数会影响结果,相关比例为加权估计,应按约一两个百分点的精度理解。
这项检查没有评估智能体是否遵守指令,也没有验证代码质量是否提高;规则文件被成功加载,只是研究所衡量的范围。