retool-query について
retool-queryは、Retool時代のモデレーションテーブルやxguard-labテーブルを含む、モデレーター用PostgreSQLデータベースを調べるコマンドラインスキルです。モデレーションデータを調査する開発者向けで、書き込みは初期状態では禁止され、ユーザーの許可後に有効化します。
主な機能
- 01SQLによるPostgreSQLクエリ
- 02初期設定は読み取り専用
- 03書き込みには許可が必要
- 04タイムアウトとJSON出力
- 05ファイルからSQLを読み込み
活用シーン
- 01UserNotesテーブルの構造確認
- 02ユーザーのモデレーションメモ検索
- 03Retool時代のモデレーションデータ調査
- 04許可を得てモデレーションメモを追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ civitai/ civitai --skill retool-queryインストール後、Claude Code で/retool-queryを入力して読み込まれたか確認します。
同梱ファイル.env.examplequery.mjs
詳細
モデレーター用データベースクエリ
モデレーター用 PostgreSQL データベースにクエリを実行します。MODERATOR_DATABASE_URL は、2026-08-21 の統合以降、1 つのインスタンスとなっており、Retool 時代のモデレーションテーブル(UserNotes、UserStrikes、ReToolActions、…)と xguard-lab テーブルを保持しています。
クエリの実行
node .claude/skills/retool-query/query.mjs "SELECT * FROM \"UserNotes\" LIMIT 5"
オプション
| フラグ | 説明 |
|---|---|
--writable | 書き込み操作を許可します(ユーザーの許可が必要です) |
--timeout <s>, -t | クエリのタイムアウト時間(秒)(デフォルト:30) |
--file, -f | ファイルからクエリを読み込みます |
--json | 結果を JSON として出力します |
--quiet, -q | 結果のみを最小限の形式で出力します |
例
# List tables
node .claude/skills/retool-query/query.mjs "SELECT tablename FROM pg_tables WHERE schemaname = 'public'"
# View UserNotes schema
node .claude/skills/retool-query/query.mjs "SELECT column_name, data_type, is_nullable FROM information_schema.columns WHERE table_name = 'UserNotes'"
# Look up notes for a user
node .claude/skills/retool-query/query.mjs "SELECT * FROM \"UserNotes\" WHERE \"userId\" = 12345 ORDER BY created_at DESC LIMIT 10"
# JSON output
node .claude/skills/retool-query/query.mjs --json "SELECT * FROM \"UserNotes\" LIMIT 3"
安全機能
- デフォルトでは読み取り専用:
--writableフラグが使用されない限り、書き込み操作をブロックします - 明示的な許可が必要:
--writableを使用する前に、必ずユーザーに許可を求めてください - タイムアウト保護:デフォルトのタイムアウトは 30 秒です
使用する場面
UserNotesテーブルのスキーマを調べる- 特定のユーザーのモデレーションメモを検索する
- 新しいモデレーションメモを書き込む(
--writableを使用) - Retool 時代のモデレーションデータを調査する
コメント
Markdown 対応