code-explanation について
既存の ADVPL と TLPP コードを説明するスキルです。ルーチンやコード片を理解したい開発者や機能コンサルタント向けに、初級・上級・非技術者の各層に合わせて解説し、ネイティブ関数、業務プロセス、SQL の情報も補足できます。
主な機能
- 013 段階の対象者向け解説
- 02初級者向けの行単位の説明
- 03上級者向けのロジックとリスクの要約
- 04コンサルタント向けの業務説明
- 05任意のネイティブ関数と SQL の補足
活用シーン
- 01既存コードを使った開発者のオンボーディング
- 02文書のないレガシールーチンの理解
- 03カスタマイズ内容のコンサルタントへの説明
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill code-explanationインストール後、Claude Code で/code-explanationを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
ADVPL/TLPP コードの解説
このスキルでは、既存の ADVPL/TLPP コードを平易な言葉で説明するための手法を提供します。対象者は、行ごとの詳細な説明を必要とするジュニア開発者、ビジネスロジックの概要とリスク、技術的負債を知りたいシニア開発者、そして業務の観点からルーチンの内容を非技術的に把握したい機能コンサルタントの3段階です。
ユーザーが既存のルーチン、関数、またはコードスニペットの説明を求めている場合に、このスキルを有効にしてください。たとえば、新しい開発者のオンボーディング、ドキュメントのないレガシーコードの理解、カスタマイズ内容の機能コンサルタントへの説明などが該当します。対象のコードを読み、要求された(または確認した)説明レベルを判断して、それに応じた形式で出力を構成します。必要に応じて、ネイティブ関数の意味、業務プロセスの背景、SQL の詳細も補足します。
このスキルでは、Protheus.doc ヘッダーやルーチン仕様書など、正式なドキュメント成果物の作成(documentation-patterns を参照)、ネイティブ関数の構文だけを調べること(protheus-reference を参照)、埋め込み SQL マクロの意味を詳しく説明すること(embedded-sql を参照)は扱いません。
| リファレンスファイル | 読むタイミング |
|---|---|
| reference.md | 常に。説明レベル、各レベル(junior/senior/funcional)に応じた構成、分析プロセスが記載されています。 |