Refactor Code With Clean Architecture Skill 技能

技能简介

Refactor Code With Clean Architecture 是 sickn33 在 Skillstore 发布的代码重构类技能，质量评分 78/100。它面向 Claude、Codex、Claude Code 三类 Agent，专门解决一个普遍痛点：复杂的遗留代码既难改又难扩展，每次"小改动"都像拆炸弹。该技能引导 Agent 用干净的代码原则 + SOLID 设计理念 + 增量可验证步骤，把混乱的代码逐步重构成结构清晰、易于维护的形态，并保证外部行为稳定不变。

核心能力

• 代码异味诊断：识别长方法、重复逻辑、紧耦合、过度嵌套、命名混乱、可测试性差等典型代码异味（code smells），并标注风险等级。
• 增量重构规划：把大型重构拆解为多个独立可验证的步骤，给出执行顺序和影响评估，避免一次性大改带来的回归风险。
• Clean Code 与 SOLID 应用：在重构过程中强制应用单一职责、开闭原则、里氏替换、接口隔离、依赖倒置五大原则，提升代码结构性。
• 行为稳定性保护：除非用户明确授权，否则严格保持外部 API 行为不变；新增或修改的代码必须有测试覆盖。
• 测试驱动验证：每个重构步骤完成后自动运行相关测试，输出验证报告，未通过则回滚到上一步。
• 决策框架输出：内置 playbook 提供常见重构场景的决策模板（如"是否提取方法"、"何时拆分类"），让 Agent 的判断更可解释。

安装配置

# 方式一：通过 Skillstore CLI 安装
npx skillstore add sickn33/code-refactoring-refactor-clean

# 方式二：手动克隆 GitHub 仓库
git clone https://github.com/sickn33/antigravity-awesome-skills.git
cd antigravity-awesome-skills/skills/code-refactoring-refactor-clean

# 方式三：在 Claude Code 中通过 marketplace 添加
claude plugin add sickn33/code-refactoring-refactor-clean

安装前建议准备好：项目源码、单元测试套件、CI/CD 配置文件、覆盖率报告工具，确保 Agent 在重构时能够验证行为不变性。

使用步骤

1. 诊断阶段：调用技能扫描目标模块，Agent 输出代码异味清单 + 优先级排序 + 风险评级（高/中/低）。
2. 规划阶段：Agent 生成增量重构计划，每一步包含"目标 → 涉及文件 → 预期影响 → 验证方法"，并明确哪些是行为保持、哪些需要新增测试。
3. 测试基线确认：开始前运行完整测试套件，确保 baseline 100% 通过；记录当前覆盖率作为后续对比基准。
4. 执行第一个切片：按规划从最低风险、最高收益的步骤开始；Agent 应用 Clean Code 模式（如 Extract Method、Move Method、Replace Conditional with Polymorphism）。
5. 验证 + 回滚机制：执行后立即运行相关测试；如果失败，Agent 提供回滚到上一步的具体命令（git revert / undo）。
6. 重复迭代：按计划依次执行后续步骤，每步保持小颗粒度，确保每次代码审查都能聚焦一个明确的改动。

适用场景

• 遗留模块解耦：把一个上千行的"上帝类"逐步拆分为多个职责单一的类，便于后续维护。
• 重构以支持新功能：现有代码结构阻碍新需求实现时，先做小颗粒重构再添加 feature，降低 feature 引入回归的风险。
• 代码评审辅助：在合并 PR 前获得结构化的重构建议 + 影响评估 + 验证结果，减少人工评审的工作量。
• 技术债务清理 Sprint：在专门的"重构 Sprint"中批量处理高风险模块，Agent 输出统一的进度跟踪表。
• 新人接手复杂代码：让新成员用技能先做一次"建议模式"扫描，快速理解代码结构和潜在改进点。

适用人群

• 维护大型遗留系统的高级工程师
• 关注代码质量的 Tech Lead / 架构师
• 想要建立团队统一重构规范的项目负责人
• 对 Clean Code 与 SOLID 感兴趣但缺乏实战经验的中级开发者
• 在 PR 评审中需要客观重构建议的 Code Reviewer

工作原理

技能的核心是"小步可验证"的重构方法论。它不依赖外部工具，而是通过 prompt 引导 Agent：先用静态分析思路扫描代码异味 → 按 SOLID 原则生成重构方案 → 把方案切分为独立可回滚的步骤 → 每步完成后强制要求测试通过 + 覆盖率不下降。整个过程输出结构化的报告（包括决策依据、影响范围、回滚指令），让人类工程师始终掌握控制权。技能本身不修改代码，所有改动都由 Agent 在用户确认后执行。

官方链接

• 技能页面：https://skillstore.io/skills/sickn33-code-refactoring-refactor-clean
• Markdown 源：https://skillstore.io/skills/sickn33-code-refactoring-refactor-clean.md
• Manifest：https://skillstore.io/api/skills/sickn33-code-refactoring-refactor-clean/manifest
• 作者主页：https://github.com/sickn33
• 仓库位置：https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/code-refactoring-refactor-clean