用途:审计仓库是否具备精简可用的智能体上下文栈,即简短顶层指令文件、任务级技能与重要工作的行为/实现规范,并给出改进建议。默认只读审计,仅在用户明确要求时才创建或编辑高上下文文件。
推荐三层结构:AGENTS.md 或等价文件(80-150 行,仅顶层路由);.agents/skills/<task>/SKILL.md(常见易错任务的可复用工作流);specs/<id>/PRODUCT.md 与 TECH.md(重要功能的契约)。若仓库已有等价体系(WARP.md、CLAUDE.md、CONTRIBUTING.md 等),先映射再补缺口,不强制套用。
工作流:1) 发现,可运行只读扫描 python3 scripts/scan_repo_context.py <repo-root>,并直接检查 AGENTS.md、CLAUDE.md、WARP.md、.claude/instructions.md、CONTRIBUTING.md、README.md、.github/copilot-instructions.md、.agents/skills/*/SKILL.md、specs/**/{PRODUCT,product,TECH,tech}.md;多文件重叠时记录范围与优先级而非默认合并。2) 分类为健康、缺顶层路由、顶层文件过载、复杂仓库缺规范、陈旧或分歧、不宜修改等状态。3) 按 references/standards.md 评分。4) 建议以最小有用改动为先。5) 用户要求生成或应用 AGENTS.md 时转交 agentsmd-scaffold;需要 PRODUCT/TECH 模板时读 references/templates.md。
限制:审计期间不编辑高上下文文件;不因缺失就新增 AGENTS.md;小型修复仓库不建规范;不静默统一命名;批量规范化前先人工验证 2-3 个仓库。资源含 scripts/scan_repo_context.py、references/standards.md、references/templates.md。