SuperAPI AI 工具集

config-audit

编程与开发

查看项目

更新于 10-16 08:46

技能介绍

config-audit 用于审计仓库中的 Claude 配置是否符合 docs/config-guidelines.md 的规范,全程只读,除生成的 audit-report.md 外不修改任何文件。触发方式包括 /config-audit、audit config、audit claude config、review configuration、configuration health check。

主要流程:先判定运行模式——全局模式(CWD 为 claude-config 仓库,需根目录存在 install.sh、skills/_shared/,或目录名为 claude-config/agent-config)、项目模式(CWD 根目录存在 CLAUDE.md)、无配置模式(无 CLAUDE.md 则停止并提示先运行 /project-setup --interactive)。随后定位指南文件:全局模式读 CWD 的 docs/config-guidelines.md;项目模式读 ~/.claude/docs/config-guidelines.md 作为只读基线,项目自身 CLAUDE.md 为审计对象。指南缺失则报 CRITICAL 并停止,不出部分报告。

接着按模式枚举目标文件并运行检查矩阵,覆盖令牌预算、职责分离、反重复、OS 正确性、engram 归属、强制内联表、技能格式、两层重复(仅项目模式)、~/.claude/ 孤立项(仅全局模式)及交叉引用等检查。每个发现记录严重级别(CRITICAL/WARNING/SUGGESTION)、文件、行号、所引原则、一句话描述与修复提示,并按严重级别、文件路径、行号稳定排序。同类同文件发现超过 20 条时合并为一条。

最后写出 repo 根目录的 audit-report.md,固定包含标题、生成时间、指南版本、Summary 计数、按级别分组的发现、无问题区块与下一步说明,使用 CRIT-1、WARN-1、SUGG-1 等稳定 ID 便于 config-refactor 精确引用。随后在对话中打印摘要(三项计数、前三项 CRITICAL、报告路径),并提示运行 /config-refactor 应用或先查看报告。限制:仅审计 Step 2 列出的文件,不中途扩大范围;不自行发明规则,每条发现都须引用指南原则;不在对话内联提出修复方案。