Refactor Code Safely with Test-Driven Workflows Skill 技能

技能简介

Refactor Code Safely with Test-Driven Workflows 是 sickn33 在 Skillstore 发布的 TDD 重构专项技能，质量评分 78/100（revision r2）。它把测试驱动开发（TDD）方法论系统性地应用到重构阶段，让 AI Agent 在做大规模结构调整时始终有测试基线作为"安全网"。特别适合大型遗留系统的渐进式改造，以及在团队内推行"重构即 TDD"规范。

核心能力

• 测试基线建立：重构开始前自动运行现有测试套件，记录覆盖率、性能基线、关键路径测试结果，作为后续对比的锚点。
• 代码异味识别 + 重构技术映射：内置常见代码异味清单（长方法、重复代码、特性依恋等），并对每个异味给出推荐的重构技术（如 Extract Method、Replace Magic Number with Symbolic Constant）。
• 小步迭代 + 每步验证：把重构拆解为粒度极小的步骤（每步 1 个 commit），每完成一步立即运行相关测试集，未通过则阻塞后续步骤。
• SOLID 原则落地：在每步重构后自动检查是否引入了新的 SOLID 违反（如循环依赖、新增的紧耦合），给出修复建议。
• 前后对比量化：用覆盖率、性能指标、测试通过率、静态分析分数等多维度对比"重构前 vs 重构后"，让改进可量化。
• 失败恢复指引：当某步重构破坏测试时，Agent 自动给出回滚到上一个绿色 commit 的具体命令和决策依据。

安装配置

# 方式一：通过 Skillstore CLI 安装
npx skillstore add sickn33/tdd-workflows-tdd-refactor

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

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

安装前需要确保：项目已有可运行的测试套件（pytest / JUnit / Jest 等）、CI 能输出覆盖率报告（推荐 coverage.py / Istanbul）、版本管理工具（Git）。

使用步骤

1. 建立基线：先运行完整测试 + 覆盖率 + 性能测试，记录当前状态作为"绿点"基线。
2. 选定第一个重构目标：让 Agent 扫描出"代码异味清单 + 推荐技术 + 预期影响"，从中挑选一个最小的目标。
3. 写一个失败测试（如必要）：如果当前测试覆盖不足，先为要保护的行为补充一个失败测试（characterization test）。
4. 应用最小重构：Agent 用对应的重构技术（如 Extract Method、Move Field）做最小改动，确保行为不变。
5. 验证 + 提交：运行相关测试 → 全部通过 → 提交一个独立 commit（带清晰 message 说明本次重构）。
6. 下一个目标：重复步骤 2-5，直到异味清单清空或达到本轮 Sprint 目标。

适用场景

• 遗留模块渐进改造：用 TDD 节奏把一个 3000 行的"上帝类"逐步拆分，每步都可回滚。
• 重构方案评审：在合并别人的重构 PR 前，让 Agent 用本技能评估——是否满足"小步 + 测试先行 + 行为不变"原则。
• 教学与团队赋能：给初级工程师演示"测试先行的重构是怎么做的"，比抽象讲解更直观。
• 性能优化前置：先用重构把代码结构理顺，再做性能优化——避免"边优化边改结构"导致的回归。
• 架构演进：从单体到微服务、从 MySQL 到 PostgreSQL 等大改造中，用 TDD 重构方法确保每次迁移都可验证。

适用人群

• 推崇 Kent Beck / Martin Fowler 重构方法论的工程师
• 需要在团队中推广 TDD 文化的 Tech Lead
• 负责核心代码库演进的高级开发者
• 对"安全重构"有刚需的金融 / 医疗 / 嵌入式系统开发者
• 想要建立可量化重构流程的工程效能团队

工作原理

技能的本质是"TDD 红绿重构循环"的方法论模板。它通过严格的 prompt 约束，让 Agent 在重构时严格遵循循环：红（写失败测试保护行为）→ 绿（让测试通过）→ 重构（小步结构调整 + 测试仍然通过）→ 重复。技能内置一份"重构技术 ↔ 代码异味"映射表，让 Agent 的判断有据可依；同时强制要求每步提交独立 commit，便于 git revert 回滚。整个流程在 CI 环境下执行，确保测试基线始终可信。技能本身不绑定特定测试框架，prompt 中引导 Agent 适配项目已有工具链。

官方链接

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