用途:在不改变任何可观察行为的前提下,简化并精炼代码,降低下一次变更的成本(减少耦合、隐藏状态、重复知识与意图不清)。定位为“先怀疑、后修改”的变更者,而非仅提建议者。
主要能力:按五个维度分析——可读性、DRY 与抽象(同一模式出现≥3次才抽取,受 YAGNI 约束)、职责归位(逻辑放在能承担它的最低层:实体>领域服务>应用服务>控制器)、复杂度削减(嵌套>3层重构、方法>20行抽取)、数据库分页与索引(列表查询必须分页,过滤/外键/排序列必须有索引)。支持后端、前端、测试三类工件,生成文件与迁移文件硬跳过。
使用方式:先读取项目文档(如 docs/project-reference/code-review-rules.md、project-structure-reference.md),再按阶段执行:检测工件类型与范围→确定目标(近期 git 变更或指定文件)→按维度分析→一次只应用一种重构→每次改动后运行相关测试→自递归循环直到无发现或遇到不安全/无进展/需决策的停止点→自审门。若存在 graph.db,需先用 python .claude/scripts/code_graph trace <file> --direction downstream --json 追踪下游消费者,并可用 callers_of、importers_of、batch-query 查询。修改文件后须自调用 $code-review,仅针对本次改动文件;未改动则跳过并记录原因。
适用场景:后端/前端/测试代码的简化重构、代码审查前的精炼、降低未来变更成本。
限制:仅在确定保持行为不变时才应用,不确定则不应用;不得削弱属性测试或变异测试;若简化改变可观察行为,须作为双反馈发现上报并停止,不得静默发布;不得跳过、重排或合并协议步骤,除非用户明确批准;环境无法运行所需步骤或工具时应停止并询问用户。具体收费、价格、平台支持等信息暂未提供。