技能介绍

问题从哪来

CLAUDE.md 和 AGENTS.md 会在每次会话被重新加载，占用的不是「给人看的 README 位」，而是实打实的上下文 token。Cursor、Codex、OpenClaw 等多读 AGENTS.md；Claude Code 仍读 CLAUDE.md。常见写法是把架构长文、框架教程、空泛原则堆进根文件——模型每代变强后，这些内容往往既费钱又帮倒忙。

本技能把「Agent 运行时配置最佳实践」落成可跑在项目上的检查器：机检定量 + 模型定性，产出评分卡与 Top 3 修复建议。元判据是减法优先：能挂 Hook、能下沉 docs/、能交给 linter/测试的，别写进常驻正文；只有「模型会反复犯错且没有机械手段兜底」的规则才值得占 token。

怎么跑一遍体检

确认目标目录（默认当前工作区），优先检查根目录 AGENTS.md 或 CLAUDE.md（避免双份厚文件双倍计费）。
跑 check.py 机检（可选 --json）；有 FAIL 时退出码为 1。
必须做定性复核：通读正文，纠偏机检盲区（例如「路由器 vs 图书馆」、可操作规则是否空话、高危模块目录命名、30 秒三问、是否教模型已会的内容）。
输出中文报告：总评与档位（A/B/C/D）、逐项 ✓/▲/✗，以及按「最小改动补最大漏洞」排序的 Top 3。
用户同意后再代改：拔密钥、修死链、瘦身下沉、补 Do NOT 清单、高危子目录本地配置、Hook 等，改完可再跑机检对比分数。

评分约 12 项（含安全红线 #0、篇幅 ≤200 行、禁止清单、规则可操作、指针与 Skill 路由、Hook/MEMORY/工作风格等），减法核心项 #1/#3/#4/#10 权重更高；「加内容」类缺失只小扣分，避免逼你把文件写长。

边界与分工

免费：check.py 的文本/JSON 报告与评分；本地、Docker、CI 均可。
付费增值：品牌可视化报告卡（依赖作者私有字体，外部环境不应用系统字体凑图）。
与 Claude Code 内置 /doctor 不同：内置命令查整套工具运行环境；本技能只评单个项目的 CLAUDE.md/AGENTS.md 写法。推荐先 /doctor 看上下文是否膨胀，再用本技能回答「具体删哪、怎么下沉」。
体检只读；不打开 .env、密钥文件；任何改动需先说明并获同意。