用途:refactor 是一个以“保持可观察行为不变”为硬约束的维护工作流,用于行为保持型重构、代码清理、技术债削减,以及针对指定路径、组件、层级、包或整个代码库的代码质量审计。它不会把清理请求变成新功能、缺陷修复、迁移、依赖升级或契约重设计。
主要能力:流程为“只读审计 → 重构审批 → 选中后经验证的执行 → 文档同步 → 可归档 → 经验证的归档”。审计阶段以并行只读角色完成(范围与架构梳理、行为与契约守护、结构与依赖审查、按语言的惯用法审查、测试与覆盖率审查、运行时与运维风险审查),产出稳定的 RF-* 机会清单并排序。执行阶段按小批次应用变更,仅改动已声明文件,运行声明验证;随后由独立审计者与验证者做一次有界复核(RV-*)。
使用方式:技能自带 scripts/ 目录下的辅助脚本,需先设置 SKILL_DIR 为技能绝对路径,再从项目根目录运行命令,例如: node "$SKILL_DIR/scripts/change-new.mjs" --title "<refactor audit title>" --class refactor 可加 --mode audit-only 仅出报告不执行。后续使用 manifest-approval.mjs、review-log.mjs、change-archive.mjs、context-discover.mjs、context-verify.mjs 等。审计用 refactor.md 记录命令与结果;该复核为快照式,无逐文件哈希、锁、纪元或 Git 索引检查。
适用场景与限制:适用于需要在不改变输出、错误、副作用、顺序、时序保证、持久化、协议、公共类型、支持输入和运维行为的前提下做结构性清理。必须先获得目标与可观察结果、影响范围、约束与反目标,并确认需求状态;范围未定前不得读参考、扫仓库或启动子代理。需要用户明确给出 RF-... ID 才可执行;沉默或笼统赞成不算选中。任何要改变行为、修改严格契约或严格接缝测试的工作,须记为 escalated-architect 并移交 architect。若当前行为无法确立、存在脏工作区冲突、相关既有测试失败、验证者复核未通过等停止条件下,应保留工件并报告阻塞,不得自行绕过审批。安装命令、价格与平台支持等信息资料未提供。