protheus-reference について
TOTVS Protheus の開発者向け検索スキルです。ネイティブ関数、SX データディクショナリ、REST 規約、システムパラメーターを扱い、まずローカル資料を参照し、必要に応じて段階的に TDN を検索します。
主な機能
- 01ネイティブ関数の構文と動作
- 02SX データディクショナリとフィールド確認
- 03REST API の規約
- 04MV_* システムパラメーターの参照
- 05ローカル優先、必要時に TDN 検索
活用シーン
- 01ネイティブ関数の引数や戻り値の確認
- 02SX3 に基づくフィールド検証
- 03Protheus 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) |