用途:依据 Robert C. Martin 的 Clean Code 原则,对代码库进行维护性评审,给出带严重级别(高/中/低)的发现报告。
主要能力:覆盖 7 个维度——命名(Meaningful Names)、函数大小与单一职责、重复与 DRY、过度设计与 YAGNI、魔法数字、结构清晰度、项目规范一致性。按维护性影响评定严重级别并优先输出高杠杆问题,而非罗列大量低级别气味。核心原则是行为保持:只针对实现方式提建议,不建议改变代码功能、输出或行为。报告先给 Summary,再按严重级别排序的 P 编号发现,随后是值得保留的模式和重构所需测试缺口。
使用方式:流程为扫描代码库(未指定范围时默认最近改动的代码)、逐维度检查、评级、生成报告。项目规范可参考项目根目录 CLAUDE.md / AGENTS.md 及 linter 配置(.eslintrc、.prettierrc、ruff/flake8 配置)。若代码库以 Python 或 Go 为主,可查阅 references/language-patterns.md;需要更丰富案例时查阅 references/detailed-examples.md;输出前查阅 references/output-template.md。支持多智能体并行,可按维度、模块/目录、语言或文件类型拆分,合并时去重并协调严重级别。
适用场景:文件/函数级别的 Clean Code 评审,不修改代码。架构与模块边界、TypeScript 类型安全、实际执行重构、React 组件设计等应转用其他技能(如 hai-architecture、ts-type-safety-reviewer、code-simplifier、component-diagnosis 等)。
限制:仅报告发现,不自动应用重构;具体安装命令、收费与价格信息暂未提供。