SuperAPI AI 工具集

context-audit

编程与开发

查看项目

更新于 10-15 23:32

技能介绍

用途:审计项目三层上下文管理体系(CLAUDE.md、.claude/rules/ 规则、docs/knowledge/ 知识)是否符合渐进式披露架构,即 CLAUDE.md 描述架构、规则内联“> 详见”引用知识、知识按需加载。适用于新增知识文件、重构规则、周期性检查或接入新领域后核验覆盖情况。

主要能力:分阶段执行。第一阶段发现文件,使用 find docs/knowledge/ -name ".md" -type f、find .claude/rules/ -name ".md" -type f 和 ls CLAUDE.md 扫描,目录不存在则跳过对应检查。第二阶段交叉引用审计:将知识文件标记为直接覆盖、间接覆盖(被规则覆盖的知识索引引用)、孤立或已弃用;校验规则中引用的目标是否存在,区分有效与失效,并排除 xxx.md、foo.md、<filename>.md 等占位示例。第三阶段检查 CLAUDE.md 合规:统计直接知识引用数,超过 3 条提示索引泄漏,规则到知识域的汇总表不算违规。第四阶段输出结构化报告,含覆盖统计、孤立文件、失效引用、合规状态、覆盖映射与弃用文件。第五阶段可选给出修复建议,但不自动应用。第六阶段提供规则瘦身方法(整文件迁移、文件内拆分、索引抽取三级)。第七阶段可选正向审计:依据变更摘要或 git log 生成变更影响矩阵,标记已更新、缺失与冲突。

使用方式:将该技能指向项目执行即可,报告按用户语言输出。

限制:只读,不修改文件,不自动修复;项目无关,但依赖 docs/knowledge/ 与 .claude/rules/ 结构;弃用文件不算失败;其他细节暂未提供。