checklist について
データベースを変更せずに本番運用への準備状況を監査し、結果を固定チェックリストに対応付けて、GO、GO WITH CAVEATS、NO-GO の判定を返すスキルです。ファイルやデータベースを変更せずにリスクを確認したいチーム向けです。
主な機能
- 01読み取り専用のデータベース監査
- 02固定の本番準備チェックリスト
- 03PASS・WARN・FAIL・NEEDS-LIVE の状態
- 04チェック項目と検出 ID の対応付け
- 05データベース種別に応じた N/A 判定
- 06阻害要因を添えたリリース判定
活用シーン
- 01本番リリース前のスキーマ確認
- 02データベースの信頼性に関する不足の特定
- 03既存の監査結果の確認
- 04オフライン確認とライブ検証の区別
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ hainrixz/ claude-db --skill checklistインストール後、Claude Code で/checklistを入力して読み込まれたか確認します。
詳細
/claude-db:checklist
本番稼働の準備状況を判定する GO/NO-GO のチェックリストです。読み取り専用で監査を実行し、結果を固定のリリースチェックリストに対応付けます。ファイルへの書き込みやデータベースの変更は一切行いません。
$ARGUMENTS = <path|connection-target> [flags]。対象にはリポジトリのパス(スキーマ/ORM/マイグレーションファイル)を指定します。また、Tier 1/2 の検証には、必要に応じて $DATABASE_URL 経由で稼働中のデータベースを指定できます。対象が指定されず、アーティファクトも見つからない場合は、その旨を伝え、/claude-db:start または /claude-db:design を提案してください。
実行内容
-
対象と
--tierフラグを指定して db-orchestrator スキルを呼び出し、読み取り専用の監査(スタックの検出 → スキーマの解析 → 監査サブエージェントの実行 → 検出結果の統合 → スコアの算出)を実行します。ユーザーがfindings.jsonを渡した場合は、それを再利用します。 -
統合された検出結果を、以下の固定チェックリストに対応付けます。各項目にステータス(PASS(満たしている)、WARN(ブロッカーではない不足)、FAIL(ブロッカーとなる不足)、NEEDS-LIVE(稼働中の接続またはより高いティアなしでは確認できない))と、その判定根拠となる検出 IDを付けます。
Check What it verifies PITR/バックアップ ポイントインタイムリカバリーまたはバックアップポリシーが設定されている — デフォルトは NEEDS-LIVE 1 テナントテーブルの RLS マルチテナントテーブルで行レベルセキュリティが強制されている FK インデックス すべての外部キー列がインデックスでカバーされている 金額に numeric を使用 金額列に numeric/decimalを使用し、float は使用していないtimestamptz/UTC タイムスタンプがタイムゾーン対応で、UTC で保存されている 接続プーリングの適正な設定 プールがプラットフォームの上限に合わせて設定されている マイグレーションの可逆性 マイグレーションに動作する down/ロールバック処理がある スキーマにシークレットがない スキーマまたは DDL に認証情報/シークレットが埋め込まれていない charset/utf8mb4 MySQL が utf8mb4(完全な Unicode)と適切な照合順序を使用している -
グリッドをテーブルとして表示します(Check・Status・Finding id・1 行の注記)。
NEEDS-LIVEの項目は明確に区別し、解決に必要なティアを記載します。検出されたエンジン/パラダイムに該当しないチェック(例:非リレーショナルストアでの RLS や utf8mb4)は、理由を添えて N/A と表示します。暗黙の PASS にしてはいけません。 -
最初に平易な言葉での判定を示します。GO(FAIL なし)、GO WITH CAVEATS(WARN/NEEDS-LIVE のみ)、NO-GO(FAIL が 1 件以上)のいずれかを提示し、主なブロッカーを 1 文で説明します。
最後に次の提案を示してください。「安全で可逆的な修正を適用するには /claude-db:fix を実行するか、最初に取り組む内容を確認するには /claude-db:next を実行してください。」全体を通して読み取り専用で実行します。ユーザーの言語(EN/ES)で回答してください。
Footnotes
-
バックアップ/DR/PITR を監査する静的モジュールはないため、この項目はデフォルトで NEEDS-LIVE として表示されます。確認できるのは Tier 1(稼働中の接続/プロバイダー設定)のみです。オフラインでは
needs_apiと報告され、設定済みと見なされることはありません(暗黙の PASS にはなりません)。 ↩