用途
SPARC Refinement 是 SPARC 方法论中的精炼阶段专项技能，用于对已完成架构设计的代码进行迭代式改进。其核心目标是通过测试驱动开发（TDD）、代码优化、重构、性能调优和错误处理强化，持续提升代码质量、可靠性与性能。
主要能力
该技能围绕 SPARC 精炼阶段的核心概念组织，涵盖以下方面：
- 测试驱动开发（TDD）：先写测试，驱动实现
- 代码优化与重构：改善代码结构
- 性能调优：优化热路径
- 错误处理改进：增强失败恢复能力
- 文档增强：保持文档与代码同步
TDD 循环分为三个阶段：Red（编写失败测试，定义预期行为）、Green（编写最小代码使测试通过）、Refactor（在测试通过的前提下改进代码）。
该技能文档提供了多种实现模式与示例：
- 认证服务的完整 TDD 实现（Red 阶段编写登录测试，Green 阶段实现最小可用逻辑，Refactor 阶段抽取验证、认证、会话创建与失败处理等方法）
- 性能优化示例：将多次数据库查询改为带缓存的单次 JOIN 查询
- 错误处理示例：自定义错误类层级（AppError、ValidationError、AuthenticationError）与全局错误处理器
- 断路器模式实现：支持 CLOSED / OPEN / HALF_OPEN 状态切换，防止对故障外部服务的持续调用
- 复杂度降低示例：将高圈复杂度的嵌套条件逻辑改为处理器工厂模式
配置与使用方式
提供 sparc-refinement-config.yaml 配置示例，包含：
- tdd_settings：循环模式（red-green-refactor）、覆盖率阈值（80）、测试框架（jest）
- refactoring：最大复杂度（10）、最大文件行数（500）、最大函数行数（30）
- performance：基准测试开关、性能剖析开关
- quality_metrics：代码覆盖率（80）、圈复杂度（10）、可维护性指数（20）
调用方式示例：在 Claude Code 中直接使用，如「Use SPARC refinement to implement login with TDD approach」，或调用 SPARC Refinement/TDD 阶段。
执行清单包括：为新功能编写失败测试（Red）、实现最小代码通过测试（Green）、在测试通过下重构（Refactor）、优化热路径性能、添加全面错误处理、实现重试与断路器、验证覆盖率≥80%、检查圈复杂度<10、运行完整测试套件、更新文档。
集成点包括 MCP 工具（用 store 动作存储精炼阶段指标，如覆盖率、测试通过状态、复杂度）以及钩子（精炼前运行 npm test --if-present，精炼后运行 npm run test:coverage）。
适用场景
- 采用 TDD 方式实现新功能
- 在保持测试覆盖率的前提下重构代码
- 优化现有代码性能
- 改进错误处理与弹性
- 提升代码质量与文档
前置条件与限制
使用前需满足：完成架构阶段并有清晰的组件设计、配置好测试框架（Jest、pytest 等）、理解 TDD 红-绿-重构循环、了解代码质量指标。
成功标准：代码覆盖率≥80%、圈复杂度<10、所有测试通过、无性能回退、为所有失败路径提供错误处理。
错误处理建议：重构后测试失败应回退并做更小改动；覆盖率低应补充未覆盖路径的测试；复杂度过高应抽取方法或使用模式；性能回退应剖析并优化热路径。
本文档未提供具体价格、收费模式、平台支持范围等信息。