mcpField
Q
query-builder

query-builder

github.com/thalysjuvenalデータ・データベース19248 回インストール7 週間前に更新
リポジトリ

query-builder について

Protheus ERP テーブル向けに、安全で効率的な SQL クエリを作成するスキルです。アクセス方法の選択、必須フィルターの適用、インデックスとの整合、動的値のパラメーター化を支援します。

主な機能

  1. 01Protheus のデータベース規則とフィルター
  2. 02Workarea と SQL の方式選択
  3. 03FWPreparedStatement によるパラメーター化
  4. 04SIX インデックス整合のガイダンス
  5. 05クロスデータベースのクエリ指針

活用シーン

  1. 01標準テーブルや独自テーブルへのクエリ作成
  2. 02DbSeek と Embedded SQL の選択
  3. 03必須フィルターの不足をクエリで確認
  4. 04インデックス不整合による低速クエリの調査

インストール

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

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill query-builder

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

同梱ファイル

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

cross-database.md
index-awareness.md
patterns-fwpreparedstatement.md
patterns-workarea.md
reference.md

詳細

Protheus Query Builder

このスキルは、Protheus ERP テーブルに対する正確で安全、かつ最適化された SQL の作成を支援します。プラットフォームのデータベース規約である、必須の論理削除（D_E_L_E_T_）および複数支店対応（xFilial）フィルター、ハンガリアン記法によるフィールド名、ディクショナリに基づく物理スキーマ（RetSqlName()）、SIX インデックスとの整合性を考慮します。また、適切なアクセス方法（Workarea ナビゲーション、Embedded SQL、生の TCSqlExec）の選択、必須フィルターの適用、利用可能なインデックスに合わせた WHERE 句の順序設定、SQL インジェクションのリスクを排除するための FWPreparedStatement による動的な値のパラメーター化をガイドします。

Protheus テーブル（標準の SA*／SE*／SF* またはカスタムの Z*）に対するクエリの作成、DbSelectArea／DbSeek と Embedded SQL のどちらを使うかの判断、必須フィルターの不足を確認するコードレビュー、パラメーター化されたクエリの追加、インデックスとの不整合による遅いクエリの診断、クロスデータベースコードの作成時に、このスキルを有効にしてください。BeginSQL／EndSQL のマクロ構文自体は対象外です（マクロの詳細については、関連スキルの embedded-sql を参照してください）。また、書き込み時のレコードロックのセマンティクスも対象外です（protheus-locks-deadlocks を参照してください）。

参照ファイル読むタイミング
reference.md常に — データベース規約、テーブル／フィールドの命名、必須フィルター、アクセスパターンの選択概要
patterns-workarea.mdDbSelectArea + DbSeek + RecLock を使ってレコード単位のコードを生成する場合
patterns-fwpreparedstatement.mdパラメーター化された TCQuery／TCSqlExec、LIKE 句、INSERT／UPDATE／DELETE を作成する場合
index-awareness.mdインデックスの選択／検証、WHERE 句の順序設定、一般的な SIX キー式を確認する場合
cross-database.mdChangeQuery()、TCGetDB()、DBAccess マクロ、MSSQL／PostgreSQL／Oracle の同等機能を使用する場合

コメント

Markdown 対応