audit について
auditは、設計の整合性とパフォーマンスを評価するための読み取り専用データベース監査スキルです。複数のチェックを並行して実行し、個別のスコア、根拠、優先順位付きの対応案を示します。
主な機能
- 01データベース構成の検出とスキーマ解析
- 02読み取り専用監査の並行実行
- 03設計とパフォーマンスを個別に採点
- 04複数データストアの結果集約
- 05根拠付きの優先対応リスト
活用シーン
- 01リポジトリのスキーマやマイグレーションを監査
- 02稼働中データベースで検出結果を検証
- 03複数データストアの監査結果を比較
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hainrixz/ claude-db --skill auditインストール後、Claude Code で/auditを入力して読み込まれたか確認します。
詳細
/claude-db:audit
データベースの完全な読み取り専用監査です。ファイルへの書き込みやデータベースの変更は一切行いません。Tier 1/2 でも、実行するのは読み取り専用の検証クエリのみです。
$ARGUMENTS = <path|connection-target> [flags]。対象はリポジトリのパス(スキーマ/ORM/マイグレーションファイル)で、オプションとして、Tier 1/2 の検証用に $DATABASE_URL 経由で稼働中のデータベースを指定できます。対象が指定されておらず、作業ディレクトリにスキーマ/ORM/マイグレーションの成果物も見つからない場合は、合格したと捏造せず、そのことを明確に伝え、/claude-db:start(成果物がない状態からのガイド付きウィザード)または /claude-db:design(グリーンフィールド)を提案してください。
実行内容
- 対象とフラグを指定して、db-orchestrator スキルを呼び出します。このスキルは、スタック(
scripts/detect-stack.mjs— パラダイム/エンジン/ORM/プラットフォーム)を検出し、スキーマを解析し(scripts/parse-schema.mjs/parse-orm-python.py)、到達したデータティア(0/1/2)を記録し、読み取り専用の監査サブエージェントを並列に実行し、検出結果を統合して、db-score を実行します。 - 次の内容を提示します。
- 2 つのスコア、Design & Integrity と Performance & Scale を、それぞれ評価帯(A~F)と一行の解釈付きで提示します。上限適用前の
computedを、capped:trueの場合はその値と併せて示します(該当する軸でfail+severity:5がある場合、その軸のスコアは F が上限です)。2 つのスコアを決して混ぜないでください。 - 各スコアのカテゴリ別内訳(値、重み、有効かどうか)、検出されたパラダイム/エンジン、到達したティア、
needs_apiチェックの件数(スコアの信頼度。暗黙に合格としないでください)。 - 複数のデータストアが検出された場合は、各軸について全ストア中の最悪値の集計と、その値を決めたストア名に加え、ストアごとの内訳を提示します。
- 影響度順に並べた優先対応リストを提示します。各項目には、ステータス、重要度、根拠(実際の DDL/クエリを引用し、シークレットは伏せた
evidence.observed)、推奨事項、修正可能性(自動/提案/助言)、expected_impact(軸 + 信頼度 + 規模。高/中/低で区分し、架空の割合/レイテンシ/行数は記載しない)を含めます。
- 2 つのスコア、Design & Integrity と Performance & Scale を、それぞれ評価帯(A~F)と一行の解釈付きで提示します。上限適用前の
- 最後に、次のように案内します。「安全で元に戻せる変更を適用するには
/claude-db:fixを実行してください(変更ごとに確認できます)。マイグレーションを検証するには/claude-db:migrateを、最初に取り組むべき内容を確認するには/claude-db:nextを実行してください。」
2 つのスコアは決して混ぜません。すべての検出事項は、再現可能な根拠を含め、schema/finding.schema.json に準拠します。ユーザーの言語(EN/ES)で回答してください。
コメント
Markdown 対応