用途:对代码库中所有文件名和命名规范做系统性审计,找出不一致、反模式与违反命名标准之处。
主要能力:分阶段执行。先发现文件并提取标准,读取仓库中根目录及各目录的 CLAUDE.md,提取文件命名模式、目录结构、组件、工具、测试、配置、常量等命名规则;同时识别隐式模式,如各目录最常见命名约定、分组后缀(如 *.service.ts)与组织方式。随后逐文件审计:分析当前文件名、所用约定、是否清晰、是否匹配内容,并与显式规则、同目录隐式模式、文件类型常见约定及框架最佳实践比对。识别的问题包括大小写违规、混合约定、模糊或误导性名称、临时/迁移名(如 -v2、-new)、通用名、错误目录、缺失分组后缀等,并读取文件内容验证名称是否准确。之后做模式分析,找出系统性问题、离群文件与缺失标准。最后在 .audits/naming-audit-[timestamp].md 生成报告,含执行摘要、按严重程度与目录分类的问题、模式分析、CLAUDE.md 覆盖情况、统计与详细文件表,并向用户给出简明总结。
使用方式:当用户要求检查命名规范时触发。审计过程只读,不修改文件;需读取 CLAUDE.md 提取标准,逐文件检查并更新待办进度。
适用场景:代码库命名规范审查、重构前评估、补充 CLAUDE.md 命名文档。
限制:仅审计不重命名;不跳过任何文件;具体命令与安装方式暂未提供。