advpl-code-review について
既存の ADVPL と TLPP プロジェクトを対象とするコードレビュースキルです。品質、安全性、性能、モダナイズを評価し、ルール ID、重大度、場所、問題、修正案を示します。TOTVS SonarQube の品質ゲートへの対応付けも可能です。
主な機能
- 01ベストプラクティスの確認
- 02性能とセキュリティのレビュー
- 03モダナイズの評価
- 04ルール ID と重大度
- 05TOTVS SonarQube ルールへの対応付け
活用シーン
- 01マージ前の変更レビュー
- 02デプロイ前のコード確認
- 03オンボーディング時のコード監査
- 04TLPP 移行準備状況の評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill advpl-code-reviewインストール後、Claude Code で/advpl-code-reviewを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
reference.mdrules-best-practices.mdrules-modernization.mdrules-performance.mdrules-security.mdsonarqube-rules-catalog.md詳細
ADVPL/TLPP コードレビュー
このスキルは、既存の ADVPL/TLPP コードを体系的にレビューする手法を提供します。ルール ID(BP-*、PERF-*、SEC-*、MOD-*)、重大度(CRITICAL/WARNING/INFO)、ファイルと行、問題、修正方法を付けて指摘事項を提示します。ベストプラクティス、パフォーマンス、セキュリティ、モダナイゼーションの 4 つのレビューカテゴリを対象とし、指摘事項を公式の TOTVS SonarQube 品質ゲートに対応付けることができます。
ユーザーが、品質、コンプライアンス、セキュリティ、パフォーマンスの問題について既存コードの検査を求めている場合に、このスキルを有効にしてください。たとえば、マージ前、デプロイ前、オンボーディング監査時、.prw から .tlpp への移行準備状況を評価するときなどです。新しいコードの生成(advpl-code-generation を参照)、特定の実行時エラーやコンパイルエラーの診断(advpl-debugging を参照)、機能を追加せずにコードを再構成すること(advpl-refactoring を参照)、実際に .prw から .tlpp へ変換すること(advpl-to-tlpp-migration を参照)は対象外です。
| 参照ファイル | 読むタイミング |
|---|---|
| reference.md | 常に。レビューカテゴリ、出力形式、重大度、レビュープロセス、ルール ID の接頭辞を確認します |
| rules-best-practices.md | RecLock/MsUnlock の対応、変数のスコープ、エリア管理、エラー処理、ドキュメントを確認するとき(BP-* ルール) |
| rules-performance.md | Embedded SQL の効率、ループの効率、文字列操作、インデックスの使用状況を確認するとき(PERF-* ルール) |
| rules-security.md | SQL インジェクション、入力検証、認証情報の露出、機密データのログ記録を確認するとき(SEC-* ルール) |
| rules-modernization.md | TLPP への移行候補、名前空間の使用、OOP パターン、最新の UI フレームワークを確認するとき(MOD-* ルール) |
| sonarqube-rules-catalog.md | 指摘事項を公式の TOTVS SonarQube ルールセット(グループ G1-G5、CA/BG/CS コード)に対応付けるとき |