claude-folder-audit 用于诊断 Claude 配置的健康状况,会根据调用位置自动切换检查模式,且严格只读,唯一写入的文件是审计报告 claude-folder-audit-report.md。
用途与模式:从 agent-config 源仓库调用时进入 global-config 模式,审计 ~/.claude/ 运行时的安装漂移、缺失的技能部署与孤立产物;从含 .claude/ 的项目调用时进入 project 模式,审计项目的 .claude/CLAUDE.md、已注册技能与磁盘实际文件、以及孤立的本地技能;其他位置进入 global 模式,审计 ~/.claude/ 运行时结构。
触发方式包括:/claude-folder-audit、audit runtime、audit .claude folder、check installation drift、verify skill deployment、audit project claude config、runtime out of sync。
主要能力:解析路径时按优先级使用 $HOME、$USERPROFILE、$HOMEDRIVE+$HOMEPATH 定位 CLAUDE_DIR,无法解析则记录 HIGH 问题并停止后续检查;记录 RUNTIME_ROOT、CWD_ROOT、RUN_DATE。按优先级判定执行模式:CWD_ROOT 同时存在 install.sh 与 skills/ 目录为 global-config;否则存在 .claude/ 为 project;其余为 global。
检查项:project 模式运行 P1–P8,global-config/global 模式运行检查 1–5。P1 检查 .claude/CLAUDE.md 是否存在、是否有 Skills Registry 段、必需段(Tech Stack/Stack、Architecture、Unbreakable Rules、Plan Mode Rules、Skills Registry)、行数(<30 行为 MEDIUM,30–50 行为 LOW)、SDD 命令引用与技能路径条目。P2 验证全局路径注册,P3 验证本地路径注册,并检查 SKILL.md 的 YAML frontmatter、format 字段(procedural、reference、anti-pattern)、各格式必需的段、正文行数与 TODO: 标记。所有检查都会执行,不提前中止;发现项按 HIGH/MEDIUM/LOW/INFO 分级并附修复建议。
限制:工具为只读,不会自动修复;报告输出位置随模式而定;其余细节如完整命令、分类依据在本资料中暂未提供。