advpl-to-tlpp-migration について
旧来の ADVPL `.prw` 手続きコードを TLPP クラスへ移行するためのスキルです。互換性を保つラッパーの維持を含め、分析から設計確認、生成、検証までを TOTVS の命名規則に沿って案内します。
主な機能
- 01ADVPL から TLPP への移行手順
- 02手続きコードのクラスへの対応付け
- 03TOTVS の名前空間と命名規則
- 04互換性を保つ User Function ラッパー
- 05移行ルールと完了チェックリスト
活用シーン
- 01既存の `.prw` ルーチンの TLPP 化
- 02名前空間とクラス構成の検討
- 03`#Include` の `.th` への更新
- 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.mdmigration-rules.mdreference.md詳細
ADVPL から TLPP への移行
このスキルでは、従来の .prw 手続き型コード(ユーザー関数、静的関数、Private/Public 変数)を、namespace 宣言、data プロパティ、public/private メソッドを備えた最新の .tlpp クラスへ変換する方法を説明します。公式の TOTVS 命名規則(小文字でドット区切りの名前空間、PascalCase のクラス名、camelCase のメソッド名、アンダースコアなし)に従います。また、移行ワークフロー(分析 -> 特定 -> クラス設計へのマッピング -> ユーザーによる承認 -> 生成 -> チェックリスト -> 検証)を定義し、元の .prw ユーザー関数を、新しいクラスに処理を委譲する、後方互換性を保つ薄いラッパーとして残すことを必須とします。
既存の手続き型ルーチンを TLPP に変換したい場合、名前空間の決め方についてサポートが必要な場合、または複数の #Include ディレクティブを .th インクルードに移行する場合に、このスキルを有効にしてください。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 | 完了した移行が十分に徹底されていることを、完了と宣言する前に確認する場合 |