SuperAPI AI 工具集

code-standards-analyzer

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:从现有代码库中发现、记录并维护编码规范,强调规范应反映代码实际做法而非理想目标。适用于存量项目接手、规范审计、新人上手、规范文档同步以及新项目初始化。

主要能力:一是显式规范发现,解析 .eslintrc、.prettierrc、tsconfig.json、.editorconfig,并从 CLAUDE.md、CONTRIBUTING.md 提取规则;二是隐式规范检测,分析命名约定、导入模式、函数特征、类型安全、错误处理、注释风格与文件组织;三是反模式检测,包括 console.* 使用、硬编码密钥、any 类型滥用、超大文件、超长函数、缺失错误处理、N+1 查询与安全漏洞;四是生成带示例、置信度和违规文件链接的规范文档。

使用方式:可手动运行 /sw:analyze-standards,支持 --drift 仅检测漂移、--update 更新现有规范;也可在增量完成时用 /sw:done 0046 --update-standards 重新分析。输出文件位于 .specweave/docs/internal/governance/ 下,包括自动生成的 coding-standards-analysis.md、作为事实来源的 coding-standards.md 以及变更历史 coding-standards-history.md。

适用场景:存量项目分析、规范合规审计、新贡献者培训、规范与代码同步。

限制:隐式规范依赖有代表性的代码样本;反模式检测可能误报有意为之的代码;无法理解模式背后的业务原因。支持 TypeScript、JavaScript、Python、Java/Kotlin、Go、C#/.NET、Rust 及 React、Angular、Vue、Svelte 等,多技术治理已实现。