context-coverage 是一个跨仓库审计智能体上下文覆盖情况的技能,回答一个问题:在被分析的仓库中,智能体上下文(CLAUDE.md、AGENTS.md、/rules/ 目录、skills)与代码在哪里匹配、在哪里缺失、过薄、过时或过大。
用途与触发:适用于“audit context coverage”“哪些仓库缺少 CLAUDE.md”“组织内上下文质量如何”等请求,也可作为周期性组织健康检查。
主要能力:只展示直接测量的数字,不制造综合评分。报告包含:Things to check(约 3–10 条带数字的排序观察)、每个仓库的原始指标条与文件夹树(按 LOC 大小、按是否有上下文文件管辖及覆盖薄厚着色)、以及所有测量值的对照表。测量指标含 LOC、文件数、近 90 天提交数、距上次提交天数、仓库年龄、贡献者、根与嵌套上下文文件及其行数、/rules/、.claude/skills 数量、上下文最后修改时间及之后的代码提交数。会自动剔除 node_modules、.venv、dist 等 vendored 目录。
两种运行方式,输出相同 JSON: 模式 A(本地克隆目录,推荐):需要 git。 uv run python scripts/collect.py --dir <folder-of-repos> --out coverage-data.json uv run python scripts/render.py coverage-data.json --out coverage-report.html 模式 B(整个 GitHub 组织,无需克隆,需要已认证 gh,范围 repo + read:org): uv run python scripts/collect.py --org <org-or-user> --out coverage-data.json uv run python scripts/render.py coverage-data.json --out coverage-report.html 脚本仅用标准库;在其他机器上可用 python3 运行。
仓库选择:默认只分析近 90 天内(--active-days 调整,0 为全部)有提交的活跃仓库;用 --repos "a,b,c" 指定;用 --exclude/--include/--overrides 做排除包含,exclude 优先。报告中顶部有可实时调整范围的面板。
限制:组织模式 LOC 为按 blob 字节估算(报告中带 *),精确 LOC 需加 --clone;组织模式跳过总提交数与贡献者计数;无法读取的仓库仍会列出并带错误说明;除组织模式的 gh 调用外全部本地离线运行。阈值可在 collect.py 的 MODEL 中调整后重跑。
文件结构:scripts/collect.py(扫描生成 JSON)、scripts/render.py(生成 HTML)、references/metrics.md(指标与字段参考)、examples/ 示例报告与生成脚本。