关于 protheus-reference
面向 TOTVS Protheus 开发者的查询技能,涵盖原生函数、SX 数据字典、REST 规范和系统参数;优先查本地资料,缺少信息时再分层搜索 TDN。
主要功能
- 01原生函数语法与行为
- 02SX 数据字典及字段检查
- 03REST API 规范
- 04MV_* 系统参数参考
- 05优先本地查询,必要时搜索 TDN
适用场景
- 01确认原生函数的参数或返回值
- 02依据 SX3 验证字段
- 03检查 Protheus REST 端点规范
- 04确认函数是否受限
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill protheus-reference安装后在 Claude Code 中输入/protheus-reference确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
native-functions.mdreference.mdrest-api-reference.mdrestricted-functions.mdsx-dictionary.mdsx3-common-fields.md详细介绍
Protheus 参考
此技能是 TOTVS Protheus 生态系统的快速查询参考指南:涵盖各类别中的原生函数语法、参数和返回值(String、Date/Time、Array、Database、Interface、Network、JsonObject、ExecAuto 等)、SX 数据字典(从 SX1 Perguntas 到 SXB/SIX)、REST API 模式(FWRest 注解与旧版 WsRestFul),以及 MV_* 系统参数。
当用户需要确认原生函数的工作方式、依据 SX3 验证自定义字段、检查 REST 端点约定,或确认某个函数不在受限/仅限内部使用列表中时,请启用此技能(推荐任何函数之前,始终先检查该列表)。查询策略优先使用本地文件(native-functions.md、sx-dictionary.md、sx3-common-fields.md、rest-api-reference.md);若本地未找到,则通过 tdn-lookup 技能按层级在线搜索 TDN(依次使用 WebFetch API、Playwright API JSON 和 Playwright HTML)。
此技能不涵盖使用某个表/字段的业务流程背景(参见 protheus-business)、编写查询这些表的 SQL(参见 embedded-sql),也不涵盖生成引用这些函数的文档(参见 documentation-patterns)。
| 参考文件 | 读取时机 |
|---|---|
| reference.md | 始终读取——函数类别索引、数据字典概览、REST API 模式摘要,以及优先本地查询/TDN 查询策略 |
| native-functions.md | 查询特定原生函数的确切语法、参数和返回值时 |
| sx-dictionary.md | 了解 SX1-SX9/SIX 表结构和数据字典的程序化用法时 |
| sx3-common-fields.md | 在代码中引用字段之前,验证表上是否存在自定义字段或标准字段时 |
| restricted-functions.md | 推荐函数之前,检查函数/类是否仅限内部使用或会被阻止编译时 |
| rest-api-reference.md | 构建或编写 REST 端点文档时(FWRest 注解或旧版 WsRestFul) |