用途:把架构评估文档中的建议落地为可执行的重构,避免编码智能体在长会话、上下文压缩或多会话工作中失去架构一致性。
主要能力:将计划外置到磁盘,用三个文件作为唯一事实来源——refactor-plan.md(有序分块计划,含进入条件、步骤、退出条件)、refactor-manifest.json(机器可读进度跟踪)、refactor-log.md(追加式人类可读日志)。每个分块需可独立验证、可独立提交、粒度适中。执行时按块顺序推进,每块完成后运行测试、类型检查与 lint 作为验证门,通过后提交并记录 commit SHA。
使用方式:先读取用户提供的评估文档,提取变更点、目标架构与顺序约束;若评估含糊则停下询问。随后构建分块计划、做依赖分析(确保无循环依赖)、初始化 manifest,并让用户确认后再执行。执行循环为:读取计划、检查进入条件、更新 manifest、逐步执行、验证、提交、更新状态、记录日志。会话开始或恢复时先读 manifest、计划与日志,并运行验证确认当前状态。验证命令在首次运行时探测并记录到 manifest,如 npm test、npx tsc --noEmit、npm run lint。
适用场景:已有结构化评估(如 seam-ripper、simplicity audit 等输出)并希望安全、可追溯地完成架构级重构的项目。
限制:该技能不决定重构什么,不做架构判断,不处理计划外改进,也不跳过验证。步骤无法按计划执行、验证失败两次或发现漂移信号时必须停止并交由用户决策,不得自行变通。若项目缺少类型检查等某项验证可记录后跳过,但测试不可跳过。资料未提供具体安装命令、收费与平台信息。