用途:面向仓库级 AGENTS.md 的卫生管理,支持创建、度量、审计内容,并与各 harness 镜像(CLAUDE.md、GEMINI.md、.github/copilot-instructions.md、.cursor/rules)核对。AGENTS.md 是厂商中立、无必需字段的纯 Markdown 约定,harness 每轮都会完整加载,因此文件长度是持续的 token 成本。
主要能力:一是清单化指令文件,用 find 定位根及嵌套目录中的相关文件;二是度量,运行 python3 "$AGENTS_MD_CHECK" [path/to/AGENTS.md],报告字节、行数、标题结构、所引用的 just 配方与仓库相对路径是否存在、镜像状态,并输出 --json 字段(如 path、bytes、chain_bytes、chain_dir、root_marker、lines、byte_cap、cap_breach、near_cap、line_warn、headings、justfile、referenced_just_recipes、missing_recipes、referenced_paths、missing_paths、mirrors、diverged_mirrors、drift);三是内容审计,校验命令与路径真实存在、质量门禁与 CI 一致、PR 与提交规则显式声明,并清除叙事历史、README 重复、密钥、个人偏好等反模式;四是镜像策略,只保留一个规范 AGENTS.md,镜像仅作指针或缺失;五是嵌套文件只写子树增量;六是裁剪或重写前先展示 diff 并获显式批准;七是用 --self-test 验证。
使用方式:从已加载 SKILL.md 所在目录(scripts/agents_md_check.py)解析 AGENTS_MD_CHECK,先解析符号链接。
限制:不做个人或机器全局指令文件;不撰写 .github/copilot-instructions.md 的 Copilot 专有内容;不运行 git commit / git push,改动留在工作区;未经展示 diff 与批准不得覆盖已有文件。链超过 32 KiB 会失败。
以上依据公开资料整理。