SuperAPI AI 工具集

advpl-refactoring

编程与开发

查看项目

更新于 10-16 02:09

技能介绍

用途

该技能用于对 TOTVS Protheus 平台上已有的、可正常运行的 ADVPL/TLPP 代码进行重构、清理或重组,目标是在不改变代码行为的前提下改善其结构与可维护性。它面向的是可读性与可维护性问题,例如函数过长、嵌套过深、命名不清、代码块被复制粘贴、函数参数过多等。

主要能力

技能定义了一组安全重构模式,编号为 RF-001 至 RF-006,具体包括:

  • 提取函数(extract function)
  • 用卫语句(guard clauses)简化条件判断
  • 删除死代码
  • 按匈牙利命名法(Hungarian notation)改进命名
  • 消除重复代码
  • 减少函数参数数量

使用方式

技能规定了强制性的重构流程:

  1. 分析(analyze)
  2. 排定优先级(prioritize)
  3. 给出修改前/后的对比方案(present a before/after plan)
  4. 等待用户批准(wait for user approval)
  5. 一次只应用一项修改(apply one change at a time)
  6. 验证(verify)

同时定义了硬性安全规则:绝不改变业务逻辑;未经调用方检查,不得重命名被外部使用的符号。

技能包含一个参考文件 reference.md,应始终阅读。该文件是本技能中唯一的文件,包含全部重构模式(RF-001 至 RF-006)、重构流程以及安全规则。

适用场景

当用户希望对现有可运行代码进行重构以提升可读性或可维护性时激活本技能,典型情形包括:函数过长、嵌套过深、命名不清晰、存在复制粘贴的代码块、函数参数过多。

限制

本技能不覆盖以下情形:

  • 修复 bug 或错误(应参见 advpl-debugging)
  • 生成全新功能(应参见 advpl-code-generation)
  • 正式的质量/安全审计(应参见 advpl-code-review)
  • 将过程式 .prw 转换为面向对象的 .tlpp(应参见 advpl-to-tlpp-migration,这属于结构性范式变更,而非保持行为的清理)

关于该技能的收费、价格、平台支持范围等更多信息,资料中暂未提供。