mcpField
A
advpl-to-tlpp-migration

advpl-to-tlpp-migration

github.com/thalysjuvenal开发19147 次安装6 周前更新
代码仓库

关于 advpl-to-tlpp-migration

此技能指导开发者将旧版 ADVPL `.prw` 过程代码迁移为 TLPP 类，并通过包装函数保持兼容。流程涵盖分析、设计确认、代码生成和验证，并遵循 TOTVS 命名规范。

主要功能

  1. 01ADVPL 到 TLPP 的迁移流程
  2. 02将过程代码映射为类
  3. 03TOTVS 命名空间与命名规范
  4. 04保持兼容的 User Function 包装器
  5. 05迁移规则与完成检查清单

适用场景

  1. 01将旧版 `.prw` 例程转换为 TLPP
  2. 02规划命名空间和类结构
  3. 03将 `#Include` 指令更新为 `.th`
  4. 04在完成前检查迁移结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill advpl-to-tlpp-migration

安装后在 Claude Code 中输入/advpl-to-tlpp-migration确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

migration-checklist.md
migration-rules.md
reference.md

详细介绍

ADVPL 到 TLPP 的迁移

此技能指导如何将旧版 .prw 过程式代码（用户函数、静态函数、私有／公有变量）转换为现代 .tlpp 类，其中包含 namespace 声明、data 属性以及 public／private 方法，并遵循 TOTVS 官方命名约定（以小写字母和点分隔的命名空间、PascalCase 类名、camelCase 方法名、不使用下划线）。它定义了迁移工作流（分析 -> 识别 -> 映射为类设计 -> 用户审批 -> 生成 -> 检查清单 -> 验证），并要求保留原始 .prw 用户函数，作为精简的向后兼容包装器，委托调用新类。

当用户希望将现有过程式例程转换为 TLPP、需要帮助确定命名空间，或要将多个 #Include 指令现代化为 .th include 时，启用此技能。它不涵盖生成没有 ADVPL 前身的全新 TLPP 代码（参见 advpl-code-generation）、对仍使用 ADVPL 的代码进行保持行为不变的清理（参见 advpl-refactoring）、迁移前的代码质量审查（参见 advpl-code-review），也不涵盖修复迁移期间或之后遇到的错误（参见 advpl-debugging）。

参考文件阅读时机
reference.md始终阅读——概述、迁移策略流程、核心转换规则表、TLPP 命名约定、完整的迁移前后示例、关键迁移决策、常见错误
migration-rules.md需要查看 ADVPL 各类结构（预处理器指令、数据库操作、错误处理、UI 元素）的完整映射及其 TLPP 对应项时
migration-checklist.md在宣布迁移完成前，确认迁移是否彻底时

评论

支持 Markdown