关于 advpl-refactoring
advpl-refactoring 是用于整理现有 ADVPL/TLPP 代码且保持行为不变的技能。它提供六种重构模式,并要求先分析和审批,再逐项修改与验证。
主要功能
- 01六种保持行为的模式
- 02提取函数
- 03使用守卫子句简化条件
- 04删除无用代码并改进命名
- 05消除重复并减少参数
- 06审批与验证流程
适用场景
- 01整理过长的函数
- 02减少多层嵌套条件
- 03改进命名并删除无用代码
- 04安全合并重复代码
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill advpl-refactoring安装后在 Claude Code 中输入/advpl-refactoring确认已加载。
附带文件reference.md
详细介绍
ADVPL/TLPP 重构
此技能定义了安全的重构模式(RF-001 至 RF-006),用于改善 ADVPL/TLPP 代码结构,同时不改变行为:提取函数、使用保护子句简化条件语句、移除无用代码、将命名改为匈牙利命名法、消除重复代码,以及减少函数参数数量。它还定义了强制流程——分析、确定优先级、提供修改前后对照计划、等待用户批准、一次应用一项修改、验证——以及严格的安全规则(绝不更改业务逻辑,未经调用方检查,绝不重命名外部使用的符号)。
当用户希望重构现有的可运行代码,以提高可读性或可维护性时,启用此技能:例如函数过长、嵌套过深、名称不清晰、代码块被复制粘贴,或函数参数过多。此技能不涵盖修复 Bug 或错误(参见 advpl-debugging)、生成全新功能(参见 advpl-code-generation)、正式的质量/安全审计(参见 advpl-code-review),或将过程式 .prw 转换为面向对象的 .tlpp(参见 advpl-to-tlpp-migration;这属于结构范式变更,而非保持行为不变的清理)。
| 参考文件 | 阅读时机 |
|---|---|
| reference.md | 始终阅读——此技能中的唯一文件;包含所有重构模式(RF-001 至 RF-006)、重构流程和安全规则 |
评论
支持 Markdown