用途：用于改进已有代码结构，而非修复故障。代码能运行但难读、违反 SOLID、逻辑重复时使用；出现报错、崩溃、行为异常时应改用 debug。触发方式包括 /refactor 命令，或用户提到 refactor、restructure、clean up、migrate、move、extract、rename、reorganize。
主要能力：分两条轨道。polish 适合不超过 5 个文件、单一关注点的小型重构，直接在主工作区进行，不委派子代理，无人工检查点。overhaul 适合架构变更、迁移和多文件重构，使用 worktree 隔离与完整委派流程，含一次合并人工检查点。两条轨道都强制包含文档更新阶段。
使用方式：默认走 overhaul，例如 /refactor "描述"；快速走 polish 用 /refactor --polish "描述"；不确定范围用 /refactor --explore "描述"。探索或简报阶段若范围扩大，可用 /refactor --switch-overhaul 切换。上下文压缩后用 /rehydrate 恢复。阶段必须顺序遍历，不能跳步，每次转换需在同一 set 调用中同时提供守卫前提与目标阶段。
关键约束：修改行为前必须先编写特征测试记录当前行为，作为判断行为是否改变的基准；重构期间不得静默修改已有特征断言，若必须改则视为行为变更并显式说明。可用 git diff -- tests/ 检查测试差异。重构中不得夹带新功能，避免范围蔓延。
适用场景：小型清理、代码搬移、提取、重命名、重组，以及架构级迁移。限制：具体命令前缀、MCP 前缀与状态文件细节依赖运行环境；未提供收费、平台与效果信息。