mcpField
A
advpl-code-generation

advpl-code-generation

github.com/thalysjuvenal開発19150 回インストール6 週間前に更新
リポジトリ

advpl-code-generation について

TOTVS Protheus 向けの ADVPL と TLPP コード生成スキルです。新しいルーチンやファイルを作成する開発者向けに、構造ルールと各種テンプレートを提供します。

主な機能

  1. 01ADVPL と TLPP の生成ルール
  2. 02命名規則と名前空間規則
  3. 03クラスと画面のテンプレート
  4. 04API、レポート、ジョブのパターン
  5. 05識別子の長さ制限

活用シーン

  1. 01Protheus の新しい関数作成
  2. 02MVC 画面や REST エンドポイントの構築
  3. 03レポートやバックグラウンドジョブの生成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill advpl-code-generation

インストール後、Claude Code で/advpl-code-generationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

catalogo-top-50-pes.md
patterns-fwformbrowse.md
patterns-fwmsprinter.md
patterns-jobs.md
patterns-mvc.md
patterns-pontos-entrada-mvc.md
patterns-pontos-entrada.md
patterns-rest.md
patterns-soap.md
patterns-treport.md
patterns-workflow.md
reference.md
templates-classes.md

詳細

ADVPL/TLPP コード生成

このスキルでは、TOTVS Protheus 向けに ADVPL（.prw）および TLPP（.tlpp）の新しいコードを生成するためのパターン、テンプレート、必須の構造ルールを紹介します。命名規則（モジュールプレフィックス、ハンガリアン記法）、Protheus.doc ヘッダーとエラー処理を含む必須の User Function スケルトン、変数スコープのルール、TLPP の名前空間規則（custom.<agrupador>.<servico>）、構造ごとの識別子の長さ制限（8／10／255 文字）を扱います。

ユーザーが新しいコードの作成を依頼した場合は、必ずこのスキルを有効にしてください。対象には、新しい関数、TLPP クラス、MVC 画面、REST エンドポイント、SOAP Web サービス、エントリーポイント、レポート、バッチジョブ、その他の新しい .prw／.tlpp ファイルが含まれます。既存コードのレビュー（advpl-code-review を参照）、既存コードのエラー修正（advpl-debugging を参照）、機能を追加せずに既存コードの構造を改善すること（advpl-refactoring を参照）、レガシーな .prw から .tlpp への変換（advpl-to-tlpp-migration を参照）は対象外です。

以下のリファレンスファイルとパターンファイルには具体的なテンプレートが記載されています。記憶に頼るのではなく、生成するコードの種類に合ったパターンファイルを読んでください。

リファレンスファイル読むタイミング
reference.md常に。概要、命名規則、必須の User Function 構造、名前空間ルール、識別子の長さ制限、よくある間違い
templates-classes.mdTLPP クラス（データ、メソッド、コンストラクター）の生成時
patterns-mvc.mdMVC 画面（ModelDef／ViewDef／MenuDef）の生成時
patterns-rest.mdREST API エンドポイント（WsRestFul または TLPP の @Get/@Post アノテーション）の生成時
patterns-soap.mdSOAP Web Service の生成時
patterns-treport.mdSQL を埋め込んだ TReport ベースのレポートの生成時
patterns-pontos-entrada.mdレガシー（非 MVC）エントリーポイント（ponto de entrada）の生成時
patterns-pontos-entrada-mvc.mdMVC ベースのエントリーポイントの生成時
patterns-workflow.mdProtheus ワークフロールーチンの生成時
patterns-jobs.mdスケジュール実行／バックグラウンドジョブの生成時
patterns-fwmsprinter.mdFWMsPrinter を使用した座標ベースの PDF レポートの生成時
patterns-fwformbrowse.mdFWFormBrowse を使用した一覧画面の生成時
catalogo-top-50-pes.md重複作成を避けるため、既知のエントリーポイントを確認するとき

コメント

Markdown 対応