用途:refactor-companion 用于在用户授权后,对既有代码表面进行替换、简化、迁移、切换、重新分配归属或移除旧设计形态的重构。它要求先读取事实,再以小型、一致、可证明的切片修改代码,同时保护无关工作。
主要能力:包含入口门控、模式选择(Discovery、Decision、Direct slice、Cutover)、内部重构卡片(refactor-card.md)、切片证明(slice-proof.md)、残留与切换规则(residue-and-cutover.md)以及输出格式(output-format.md)。它区分源失败与环境限制,要求用调用方、契约、搜索、diff 和运行时证据支撑。
使用方式:用户授权编辑既有代码表面;仓库、分支、工作树、提交、拉取请求或命名路径在范围内。若仅分析则保持只读;若无具体表面则先询问。流程为绑定范围、填写卡片、选择模式、进行最小一致编辑、运行聚焦证明、检查旧名称与残留、更新卡片、继续或报告边界。
限制:不确定是否可推断为重构目标时,不应进行推测性清理;未获明确授权不得 commit、push、merge、reset、rebase 或 clean;正式发现与合并决定属于独立审查工作;用户面向报告中每个仓库支撑声明需链接到具体文件与行。缺失事实暂未提供。