advpl-refactoring について
advpl-refactoring は、動作を変えずに既存の ADVPL/TLPP コードを整理するスキルです。6 つのリファクタリングパターンを備え、分析と承認の後、一つずつ変更して検証する手順を定めています。
主な機能
- 01動作を保つ 6 つのパターン
- 02関数の抽出
- 03ガード節による条件分岐の簡素化
- 04不要コードの削除と命名の改善
- 05重複の解消と引数の削減
- 06承認・検証プロセス
活用シーン
- 01長い関数の整理
- 02深くネストした条件分岐の削減
- 03命名の改善と不要コードの削除
- 04重複コードの安全な統合
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/advpl-refactoringを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
ADVPL/TLPP リファクタリング
このスキルでは、動作を変えずに ADVPL/TLPP コードの構造を改善するための、安全なリファクタリングパターン（RF-001～RF-006）を定義します。対象となるのは、関数の抽出、ガード節による条件分岐の簡略化、不要なコードの削除、ハンガリアン記法に沿った命名の改善、重複の解消、関数の引数の削減です。また、必須の手順（分析、優先順位付け、変更前後の計画の提示、ユーザーの承認待ち、変更を1つずつ適用、検証）と、厳格な安全規則（ビジネスロジックを変更しない、呼び出し元を確認せずに外部から使用されるシンボルの名前を変更しない）も定義します。
ユーザーが、既存の動作するコードの可読性や保守性を高めるために構造を変更したい場合に、このスキルを有効にしてください。対象となるのは、長い関数、深いネスト、分かりにくい名前、コピー＆ペーストされたコードブロック、引数が多すぎる関数などです。バグやエラーの修正（advpl-debugging を参照）、まったく新しい機能の生成（advpl-code-generation を参照）、正式な品質・セキュリティ監査（advpl-code-review を参照）、手続き型の .prw からオブジェクト指向の .tlpp への変換（動作を維持する整理ではなく、構造上のパラダイム変更である advpl-to-tlpp-migration を参照）は対象外です。
| 参照ファイル | 読むタイミング |
|---|---|
| reference.md | 常に。このスキルに含まれる唯一のファイルで、すべてのリファクタリングパターン（RF-001～RF-006）、リファクタリングの手順、安全規則が記載されています。 |