用途:指导安全、增量的代码重构,在不改变行为的前提下改善代码质量。技能自述为供 Claude 在执行期间阅读的参考材料。
主要能力:提供多个命令并输出到 .claude/logs/refactors/ 下的文件——refactor:analyze <file> 生成 {target}-analysis.md,refactor:plan <file> 生成 {target}-plan.md,refactor:docs <file> 输出分析、计划与摘要,refactor:quick <file> 跳过审批,refactor:performance <file> 聚焦性能,refactor:structure <file> 聚焦结构。
决策信号:检测到代码异味时先识别具体异味;测试通过时才可安全重构;没有测试则必须先写测试;变更较大时拆成小步骤。核心原则:绝不同时重构和添加功能。
异味与对应重构:长方法→提取方法;大类→提取类;长参数列表→参数对象;重复代码→提取方法或类;依恋情结→移动方法;基本类型偏执→替换为对象;switch 语句→多态;死代码→删除。
安全流程:确保测试通过,做一次小改动,运行测试,提交,重复;测试之间不做多处改动。检查清单:重构前确认测试存在且通过、理解现有行为、识别异味;过程中每次只改一处、每步之后测试、频繁提交;完成后所有测试通过、代码更整洁、行为不变。
相关规则文档:rules/core/simplicity-over-complexity.md(抽象前先遵循三次法则、先删除再提取、先扁平化再嵌套)、rules/core/tdd-workflow.md(仅在测试为绿色时重构)、rules/core/verification.md(每一步之后测试仍须通过)、rules/workflow/cross-review-workflow.md(重构者与审查者应为不同人)、skills/code-simplifier/SKILL.md(纯简化处理的配套技能)。
限制:资料未提供安装方式、许可、价格、平台与支持语言等具体信息,暂未提供。