supercent-io/code-refactoring：行为保留型重构工作流 Skill 技能

supercent-io-code-refactoring 是一款面向「行为保留型重构」的 Agent Skill。它把软件工程教科书里零散的重构手法——Extract Method、消除重复查询、长参数列表对象化、长条件分支多态化——打包成 Claude / Codex / Claude Code 三个 Agent 都能直接套用的标准化工作流，让 AI 在重构老代码时按「先写测试、再改结构、再验证行为」的纪律推进，避免把 bug 重构成新 bug。

核心能力：

• Extract Method 指引：识别长函数中的可提取片段，引导 Agent 按职责拆分方法，保留入参、出参与边界行为不变。
• 重复逻辑消除：针对重复的数据库查询、重复的工具函数调用，推荐共用 service / helper 函数。
• 长条件分支多态化：对长 if/else 或 switch 支付流程，推荐用策略模式或多态替换，提高可维护性。
• 长参数列表对象化：将散落的多个参数封装为强类型参数对象（DTO / value object），提升调用点可读性。
• 行为验证清单：内嵌可复用的「重构前 → 重构中 → 重构后」行为验证清单与对应测试命令。
• 风险与回滚记录模板：要求每次重构记录「保留的行为、潜在风险、测试状态、Follow-up」，方便 PR review 与知识沉淀。

安装配置：

• 通过 npx skillstore add supercent-io/code-refactoring 一键安装到 Claude / Codex / Claude Code Agent 环境。
• 项目已有测试套件（unit / integration）时效果最佳；缺失测试时建议先用 testing 类 Skill 补齐。
• 默认示例以 TypeScript 风格为主，其他语言（Python / Java / Go）使用时可在 prompt 中说明，Agent 会按对应语言习惯输出重构建议。

使用步骤：

1. 识别重构机会：Agent 扫描选定代码，标记长方法、重复逻辑、长参数列表、长条件分支等典型「坏味道」。
2. 确认测试基线：运行项目现有测试，确保全部通过，作为「行为不变」对照基线。
3. 制定重构计划：把每一步重构拆分为最小可验证单元，标注保留行为、潜在风险与验证命令。
4. 执行 Extract Method 等手法：按计划逐步重构，每次只做一处改动，跑测试确认行为不变。
5. 清理与回滚检查：重构完成后跑 lint、type-check、format，并检查是否引入新依赖或破坏公共 API。
6. 沉淀重构记录：用 Skill 内置模板记录本次重构的目标、改动范围、行为保留证据与后续待办。

适用场景：

• 老项目维护期，对长方法、重复代码进行渐进式清理。
• 准备在新功能开发前对模块进行「解耦 + 命名规范化」，降低新增 feature 的耦合度。
• Code review 阶段，需要给重构方案统一输出格式（含测试、风险、回滚点）。
• 团队希望把零散的重构经验沉淀为统一 SOP，避免每次重构都凭手感。

工作原理： Skill 加载后会在 Agent 推理上下文中注入「重构手法库 + 行为验证清单 + 风险记录模板」。Agent 在收到「重构这个模块 / 找安全重构点 / 设计多步重构策略」指令时，会先识别坏味道，再生成按「行为保留」原则拆分的多步计划，并要求每步给出对应测试命令与回滚点。它的设计目标是「让 AI 输出的重构方案能直接进入 PR 评审」，而不是自动执行生产代码改动。

适用人群：

• 长期维护遗留项目的资深工程师与 Tech Lead。
• 希望系统学习重构手法的中级工程师与新晋架构师。
• Code Review 中需要快速定位「可重构点」的 reviewer。
• 任何希望把重构流程沉淀为团队 SOP 的工程团队。

官方链接：

• 技能主页：https://skillstore.io/skills/supercent-io-code-refactoring
• 源码仓库：https://github.com/supercent-io/skills-template/tree/main/.agent-skills/code-refactoring/
• 安装命令：npx skillstore add supercent-io/code-refactoring