mcpField
S
smartx-development

smartx-development

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

关于 smartx-development

用于开发 TOTVS Smart X 例程的技能，涵盖从数据模型、界面到菜单启动器的实现。内容包括新建功能、集成 ADVPL、迁移旧版 MVC 浏览界面及故障排查。

主要功能

  1. 01Object 到 Launcher 架构
  2. 02Model 与 Interface 类
  3. 03PO-UI 屏幕渲染
  4. 04集成 ADVPL 操作
  5. 05迁移旧版 MVC 浏览界面

适用场景

  1. 01开发 Smart X 例程
  2. 02将 ADVPL 函数接入页面或表格操作
  3. 03将 MVC 浏览界面迁移至 Smart X

安装

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

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill smartx-development

安装后在 Claude Code 中输入/smartx-development确认已加载。

包含的文件

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

patterns-advpl-integration.md
patterns-interface.md
patterns-launcher-browse.md
patterns-migration.md
patterns-model.md
reference.md
troubleshooting.md

详细介绍

Smart X

此技能涵盖 TOTVS Smart X 例程的开发：Object -> Model -> Interface -> Launcher 链路，可将数据字典表（SX2/SX3）转换为自动渲染的 PO-UI 屏幕，无需手写 Angular 组件。文档介绍了 Model（totvs.framework.structure.model.th）和 Interface（totvs.framework.structure.Interface.th）TLPP 类所需的 include 和注解、用于在 Protheus 菜单中注册例程的 Launcher 函数、如何通过 pageActions/tableActions/事件将现有 ADVPL 函数集成到界面中，以及如何仅将旧版 MVC 例程的浏览界面（Data View）转换为 Smart X，同时保留 ModelDef/ViewDef/MenuDef。

当用户从头开始创建 Smart X 例程、将 ADVPL 函数调用接入 Smart X 页面操作或表格操作、将旧版 MVC 浏览界面转换为 Smart X 浏览界面，或排查 Smart X 屏幕/模型/界面问题时，请启用此技能。此技能不涵盖不使用 Smart X 的经典 MVC 例程开发（参见 advpl-code-generation 文件 patterns-mvc.md），也不涵盖 SX2/SX3 本身的数据字典配置脚本（参见 sx-configuration）。此技能也与 Smart View 无关；Smart View 是 TReports 分析工具，其自定义业务对象由 smartview-development 涵盖。两者名称相似，框架并不相同。

所引用的文件使用巴西葡萄牙语编写。

参考文件阅读时机
reference.md始终阅读——Smart X 概念、Object/Model/Interface/Launcher 架构、include/注解、端到端最小示例
patterns-model.md编写或审查 Model（model.tlpp）类及其数据/业务规则定义时
patterns-interface.md编写或审查 Interface（interface.tlpp）类及其 UI 契约（浏览界面/表单）时
patterns-launcher-browse.md将现有 MVC 例程的浏览界面（Data View）转换为 Smart X 渲染时
patterns-advpl-integration.md通过 pageActions、tableActions 或 onChange 等事件，从 Smart X 调用现有 ADVPL 函数时
patterns-migration.md将完整的旧版例程迁移为 100% Smart X 实现时
troubleshooting.md诊断 Smart X 屏幕、Model 或 Interface 中的错误或异常行为时

评论

支持 Markdown