SuperAPI AI 工具集

quality-refactor

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:在累积技术债需要系统性识别与安全削减时使用。先读取 .maestro/workflows/run-mode.md 与 codex-run-mode.md;若未提供范围,需向用户询问。

主要能力与用法:重构前预加载上下文,运行 maestro load --type spec --category coding 加载编码约定并应用于改后代码;运行 maestro load --type spec --category review 加载评审标准作为质量门。可用 maestro search --category coding 浏览角色知识,再用 maestro load --type knowhow --id <id1> [id2...] 加载相关条目;这些均为可选。

边界:重构仅修改已声明范围内的源文件;附属产物 reflection-log.md 必须写入 {run_dir}/outputs/;未经再次确认不得改动范围外文件。

阶段门(强制阻塞):门1分析到计划需识别受影响文件与依赖并生成含具体改动的重构计划;门2计划到执行需用户确认计划,未确认不得应用改动;门3执行到完成需每处修改均经测试验证、零回归(全部测试通过)、写出 reflection-log.md,测试失败则先修复回归再完成。

完成状态:输出 STATUS 为 DONE|DONE_WITH_CONCERNS|NEEDS_RETRY,必要时附 CONCERNS。被 Ralph 调用时以 maestro ralph complete <idx> --status {STATUS} [--evidence {path}] 结束。完成后可询问是否将重构模式记录为编码约定,若同意则用 Skill("spec", "add coding "<title>" "<pattern>" --keywords <kw1>,<kw2> --description "<summary>"")。

下一步路由:全部测试通过建议 /manage sync codebase;重构后测试失败运行 maestro run create debug --session YYYYMMDD-debug-{topic} --intent "test failures after refactor in {scope}";无测试套件则运行 maestro run create auto-test --session YYYYMMDD-auto-test-{topic} --intent "{goal}" -- {phase}。

限制与错误码:E001 范围/描述缺失需提示模块路径、功能区域或 all;E002 受影响区域无测试套件,建议先建测试或手工验证;W001 部分测试覆盖,需标注未覆盖区域并谨慎推进。成功标准:计划已确认、按计划实现、重构后全部测试通过、无回归、reflection-log.md 记录策略与结果。