SuperAPI AI 工具集

structural-refactoring

编程与开发

查看项目

更新于 10-20 08:51

技能介绍

结构性重构(Structural Refactoring)是一个面向代码重构的分析与执行技能,主张把重构当作“语义保持问题”,而不是文件搬运任务。其作用范围是回答一个判断:在保留关键行为与约束的前提下,如何把现有代码重新组织成更好的结构。技能不以文件长度、目录风格、AST 图或可用代理数量来推断边界,也不用于决定新产品行为或自行验收结果。

主要能力体现在一套结构化流程上:编辑前先做“接地”,明确实际目标与观察到的行为、结构压力或请求的改动、保留契约、影响面、最强的“不重构”替代方案、最小候选边界,以及验证与验收负责人。若请求只是影响可见的局部清理,则走常规严谨开发流程;若目标架构或期望行为尚未确定,应先交由设计或决策方处理,再进入重构。

执行时,技能先复原具体整体:阅读目标代码、调用方、测试、公共契约、已接受的设计和相关历史,并尽量运行现有验证面;区分观察到的事实与推断出的职责和偏好。随后分类改动,确认它只改变代码结构而保留具名可观察行为,并把相邻问题通过明确边界分流,而不是隐藏在重构中。

它要求建立“最小充分影响面”,只追踪可能改变边界或验证决策的内容:公共入口与直接消费者、状态/副作用/生命周期/错误/持久化/并发边界、依赖方向与强耦合定义、不变量与高风险路径,以及能暴露漂移的测试、类型、构建检查和运行时观察。事实性排查优先使用编译器、语言服务器、AST、调用点和仓库证据,模型判断用于职责、内聚与权衡。

在方案选择上,技能要求比较边界:保留最强的“不重构”理由,并比较能暴露真实权衡的最少替代方案,拒绝只缩短文件却增加跨边界流量、重复状态、不稳定接口或迁移风险的分割。注意力按比例分配,默认一个代理掌握完整影响面,仅在存在独立可复核的职责、副作用、调用方或保留风险时使用子代理或并行视角。

执行方面强调可逆检查点:按真实依赖排序,使每个检查点都能通过类型检查或运行聚焦验证;将行为变更、API 重设计、格式噪声和不相关清理排除在外,除非它们为保留契约所必需且被明确命名。逐检查点执行与观察,同步更新定义与消费者,检查差异,运行能暴露预测失败的最小检查;若观察与计划矛盾,应停止并修订影响面。

最后通过独立验证收尾:将最终结构与保留契约、公共表面、影响面和已接受边界对比,记录可追溯检查与残余风险,由指定评审者或人类接受重要重构,实施代理不得把自己的报告当作事实。完成标准要求结构压力、保留契约、影响面、选定边界、可执行检查点、可追溯验证和验收负责人全部明确;仅通过语法或类型检查只证明它们所观察的属性。若行为等价性、调用方影响或归属仍不确定,应报告不确定性而非声称完成。