platform-database について
platform-databaseは、データベース関連タスク向けのスキルです。適用範囲を判断し、参照ルールに沿って作業し、結果を検証します。スキーマや移行計画のレビューが例として示されています。
主な機能
- 01データベース作業の適用条件を判定
- 02ルールインデックスの指針を適用
- 03ワークフローに沿って結果を検証
活用シーン
- 01データベーススキーマと移行計画のレビュー
- 02スキルの未選択や指針の競合の調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ravnhq/ ai-toolkit --skill platform-databaseインストール後、Claude Code で/platform-databaseを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/_sections.mdindex-concurrent-creation.mdindex-covering-queries.mdindex-foreign-keys.mdmigration-add-columns-safely.mdmigration-forward-only.mdmigration-one-change.mdmigration-review-generated-sql.mdmigration-separate-data-schema.mdquery-avoid-functions-on-indexed.mdquery-avoid-leading-wildcards.mdquery-filter-early.mdquery-n-plus-one.mdquery-prefer-exists-over-in.mdquery-select-columns.mdquery-use-explain.mdschema-timestamps.mdschema-use-appropriate-types.mdtransaction-keep-short.mdtransaction-wrap-related-mutations.md詳細
原則
- 重複排除が必要な場合を除き、UNION ではなく UNION ALL を優先してください。
ルール
詳細なパターンについては、ルールの一覧を参照してください。
例
トリガーする例
ユーザー:「このスキーマと、ダウンタイムなしでのロールアウトに向けた移行計画をレビューしてください。」
期待される動作:platform-database のガイダンスを使用し、そのワークフローに従って、実行可能な結果を返します。
トリガーしない例
ユーザー:「このモーダルに ARIA ラベルとフォーカスリングを実装してください。」
期待される動作:platform-database を優先せず、より関連性の高いスキルを選択するか、スキルを使用せずに対応します。
トラブルシューティング
スキルがトリガーされない
- エラー:期待される場面でスキルが選択されません。
- 原因:リクエストの表現が、説明にあるトリガー条件に明確に一致していません。
- 解決策:説明に記載されているドメインやタスクのキーワードを明示して言い換え、再試行してください。
ガイダンスが別のスキルと競合する
- エラー:1 つのタスクで、複数のスキルの指示が競合します。
- 原因:読み込まれたスキルの対象範囲が重複しています。
- 解決策:現在のステップでどのスキルを優先するかを明示し、そのワークフローを先に適用してください。
出力が抽象的すぎる
- エラー:結果に具体性がなく、実行可能な詳細が不足しています。
- 原因:タスクの入力に、コンテキスト、制約、または出力形式が含まれていません。
- 解決策:具体的な制約(環境、対象範囲、形式、成功基準)を追加して再実行してください。
ワークフロー
- リクエストが
platform-databaseの対象範囲とトリガー条件に明確に一致するかを確認します。 - スキルのルールと参照先のガイダンスを適用して、具体的な結果を作成します。
- 制約に照らして出力の品質を検証します。不足が残る場合は、前提を明示して一度だけ改善します。
コメント
Markdown 対応