Openclaw向けSQL Formatter

外部依存関係なしで SQL クエリをフォーマット、縮小、検証するための純粋な Python CLI ツールです。

johnnywang2001
v1.0.0
Mar 19, 2026
0
930
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install sql-formatter

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って sql-formatter をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

SQL Formatter とは?

SQL Formatter は、SQL コードベースに一貫性と品質をもたらすために設計された Openclaw Skills エコシステム内の専用ユーティリティです。重いライブラリの依存関係なしに SQL 変換を処理するための、軽量で純粋な Python ソリューションを提供します。本番環境向けのクエリの準備でも、レガシースクリプトのクリーンアップでも、このツールは SQL が業界標準のフォーマットに従っていることを保証します。

このツールを Openclaw Skills のセットアップに統合することで、開発ライフサイクル中の自動化された SQL クリーンアップが可能になります。SELECT、INSERT、UPDATE、DELETE、CTEs (Common Table Expressions) を含む複雑な SQL 構文を処理します。このスキルを活用することで、開発者は複雑なサードパーティ製ソフトウェアを必要とせずに、複数のデータベースダイアレクトにわたってプロフェッショナルなコード標準を維持できます。

SQL Formatter のユースケース

  • Openclaw Skills ワークフロー内で、チームの読みやすさを向上させるために乱雑な SQL クエリを整形します。
  • 本番環境やクラウドデプロイメントでのペイロードサイズを削減するために SQL スクリプトを縮小します。
  • SELECT * やセミコロンの欠落などの一般的なアンチパターンを検出するために SQL ファイルを検証(Lint)します。
  • 一貫性を確保するために、大規模なデータベース移行スクリプト全体でキーワードの大文字小文字を標準化します。
  • ローカル開発環境や CI/CD パイプライン内での自動化された SQL 検証とクリーンアップ。

SQL Formatter の仕組み

  1. ユーザーは、Openclaw Skills ルーチンの一部として、生の SQL 文字列、入力ファイルパスを提供するか、スクリプトにテキストをパイプで渡します。
  2. スクリプトは SQL トークンを解析し、キーワード、句、文字列リテラル、およびコメントを識別します。
  3. 選択したコマンド(format、minify、または lint)に基づいて、ツールは SQL 構造に特定の変換ロジックを適用します。
  4. フォーマットの場合、主要な句の前に改行を追加し、ユーザーの好みに基づいてキーワードの大文字小文字を調整します。
  5. 縮小の場合、すべてのコメントを削除し、不要な空白を 1 行に折りたたみします。
  6. 検証の場合、ベストプラクティスルールのセットに照らして SQL を評価し、さらなる処理のために警告または JSON レポートを出力します。
  7. 最終結果はターミナルに返されるか、ファイルに保存されるか、シーケンス内の次のエージェントに渡されます。

SQL Formatter のセットアップ

Openclaw Skills でこのツールの使用を開始するには、Python 3 がインストールされていることを確認してください。外部の pip パッケージは不要です。

# スクリプトをダウンロードまたは配置
python3 scripts/sql_format.py --help

# 基本的なフォーマットチェック
python3 scripts/sql_format.py format --sql "SELECT * FROM users"

SQL Formatter のデータスキーマとタクソノミー

SQL Formatter は、標準の入出力を通じてデータを管理し、他の Openclaw Skills と統合するための構造化されたレポートを生成できます。

機能 説明
入力タイプ --sql による生の文字列、--input によるファイルパス、または STDIN (-)
出力形式 フォーマットされた SQL テキスト、縮小された SQL 文字列、または構造化された JSON 検証レポート
設定 --indent (整数) 用の CLI フラグと --lowercase などの大文字小文字オプション
検証チェック SELECT *、不一致の大文字小文字、末尾の空白、長い行を検出

SQL Formatter の高度な機能

  • JSON レポート: --json フラグを使用してマシン読み取り可能な検証レポートを生成し、Openclaw Skills エコシステムの他の自動化ツールと統合します。
  • パイプサポート: ターミナル中心のワークフローでのリアルタイム SQL 処理のために、パイピング (echo "..." | script) を完全にサポートします。
  • 包括的な構文サポート: CTEs、すべてのタイプの JOINs、サブクエリ、二重引用符で囲まれた識別子を含む複雑な SQL 構造を処理します。
  • カスタムインデント: 組織のスタイルガイドに正確に一致するように、ユーザーが特定のインデントレベルを定義できるようにします。
  • 依存関係ゼロのアーキテクチャ: 純粋な Python のみで動作し、さまざまな環境で高速かつポータブルであることを保証します。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*