SuperAPI AI 工具集

52-execute-refactor-150

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:该技能定义了一套名为 Execute-Refactor 150 Protocol 的三阶段重构流程,用于在改动代码前先调研方案、再计划确认与实现,最后做小范围客观清理。

主要能力与流程: 第一阶段为迭代调研,不修改代码。要求在 .sessions/SESSION_[date]-[name].md 创建或复用会话日志,所有调研笔记只写入该日志。需定义核心问题(一句话说明重构 X 以实现 Y)、定义 Scope150 范围(Core 100% 为直接改动的文件与行为,Boundary 50% 为调用方、依赖模块、测试、配置与数据流),并按接口层、领域层、模式层、使用层分层搜索阅读,记录事实与来源、区分事实与假设,产出至少两个重构选项及利弊、风险与测试影响,最后给出选项摘要、未知项与推荐路径。 第二阶段为计划、确认与实现:编写文件级粒度的有序步骤计划,列出风险与边界情况、行为变更与 API 契约风险,定义验证清单(单元/集成测试、必要的手动检查、预期输出与失败判据),并做 Scope150 验证规划;必须获得用户确认后才可编辑,实现时保持改动最小可回滚,补充或更新测试,运行验证并记录结果。 第三阶段为 Scout105 清理协议:仅在阶段完成的关键节点执行,不新增功能;允许的清理类别限于未使用代码、拼写错误、格式不一致、死代码、明显错误逻辑;约束为只处理已改动文件、每项清理验证加修复不超过 30 秒、总清理时间不超过主任务时间的 5%、必须客观可测量,且执行前需用户批准。

适用场景:适合需要谨慎推进的代码重构与模块化任务,尤其是希望先调研再动手、并保留可追溯调研日志的工程流程。

限制:资料未提供具体安装命令、依赖环境、支持平台或收费信息;流程要求用户确认与批准,且清理范围严格受限。