config-review-bot

config-review-bot

このリポジトリの CodeRabbit を監査または設定します。

絶対原則： 対象範囲と実際の動作を裏付ける最新の根拠がなければ、設定に関する主張や変更は有効ではありません。

対象範囲

このスキルの対象は、リポジトリローカルの CodeRabbit 設定です。CodeRabbit アプリや CLI のインストール、有料レビューの開始、コメントの投稿、ブランチ保護やルールセットの変更、別のレビューボットの設定は行いません。セットアップの変更には、明示的な許可が必要です。

入力

リクエストにはモードとして、audit [PR <n>]、set up、または update <change> が指定されます。モードを指定しない呼び出しは、現在のリポジトリの監査です。

1. リポジトリの指示を読みます。リポジトリの Wiki がある場合は読みますが、必須ではありません。
2. リクエストでプルリクエストが指定されている場合、主張を行う前に、正確な head SHA とベースブランチを記録します。
3. .coderabbit.yaml、リポジトリ設定、継承された組織またはワークスペースの設定を示す根拠を読みます。
4. リポジトリの動作を定めるビルド、テスト、CI の設定を読みます。
5. メインブランチ、言語、パス構成は、推測ではなく根拠に基づいて特定します。
6. 対象範囲、重大度、プリセット、ブランチ、適用についてのユーザーの明示的な決定を維持します。
7. 最新の CodeRabbit 公式ドキュメントを読みます。すべてのデフォルト値は時点依存のものとして扱い、公式ドキュメントで確認します。

完了条件：有効な設定の情報源を、ファイル、継承、UI、または 不明 として明示します。プルリクエストが対象範囲に含まれる場合は、head とベースを記録します。

監査

監査モードでは読み取り専用で作業します。スキーマの有効性、ルールの品質、レビュー完了の根拠という3つの主張を個別に報告します。

スキーマの有効性

1. --help でコマンドを確認できた場合は、coderabbit config validate <path> を優先します。
2. まず CLI のヘルプと最新の CLI リファレンスで、コマンド名とオプション名を確認します。
3. それ以外の場合は、公式 JSON Schema と、リポジトリですでに使用している YAML ツールを使って検証します。
4. 対応するバリデーターの実行が成功した場合のみ 有効 と報告します。バリデーターまたはスキーマの根拠がない場合は 検証できません と報告します。
5. すでにインストールされているツールで監査します。CLI のインストールはセットアップの変更であり、監査手順ではありません。

完了条件：判定が valid、invalid: <error>、または cannot validate: <reason> のいずれかであること。

ルールの品質

確認項目	収集する根拠
フィードバックと適用	reviews.profile はフィードバックの量を設定します。request_changes_workflow とブランチ保護は、マージの扱いを設定します。これらは個別に報告します。
ブランチの対象範囲	base_branches はデフォルトブランチに追加される正規表現のリストです。最新のドキュメントで確認します。
レビューの頻度	最新のドキュメントに記載された、差分レビュー、ドラフト、自動一時停止、レート制限のデフォルト値。
パスのカバレッジ	path_instructions と path_filters の glob を、実際に追跡されているパス名に対してテストします。ドットファイル、隠しアセットディレクトリ、拡張子のないスクリプト、テンプレート、POSIX、Bash、zsh の各方言を含めます。
テストファイル	言語固有のテストファイルが、プロジェクトで実際に使われているテストコマンドに対応していること。
ガイドライン	コードガイドラインの自動検出、その実際の適用範囲、明示的なマッピング、UI の状態。検出された指示は、その適用範囲が文書化または確認された場合にのみ適用されます。
シグナルポリシー	スタイルのみの一貫性に関する指摘は抑制されていること。セキュリティと正確性に関する指摘は有効のままであること。
重複	対象を絞ったルールが、既存のガイドライン、フォーマッター、リンター、CI チェックを繰り返していないこと。
フィクスチャ	正解データはレビュー可能な状態に保ちます。破棄可能な生成ノイズは除外します。
除外	デフォルトの除外と、このリポジトリで追加された除外を分けて報告します。

パスの確認には、スキーマだけからの推測ではなく、CodeRabbit の minimatch の仕様を使います。このリポジトリでの比較根拠がある場合にのみ、プリセットの移行を提案します。

完了条件：各行に所見、または根拠を添えた明示的な no gap があること。

レビューの完了

緑色のステータスチェックが示すことと、レビューが完了したことが示すことは異なります。レビューイベント、指摘事項、プルリクエストの正確なヘッド SHA を確認してから、レビューが実行されたと報告してください。

セットアップまたは更新

1. 要望を満たす、リポジトリ内で最小限の設定差分を提示します。
2. 推奨されるバリデーターで差分を検証するか、検証できない理由を報告します。
3. ユーザーが依頼した設定のみを変更します。テンプレートを丸ごと置き換えることは、決して解決策になりません。
4. 最終差分がユーザーの明示した判断と一致しているか、再確認します。

通常の設定依頼は差分の提示で完了します。次の操作には、それぞれユーザーからの明示的な依頼が必要です：コメントの投稿、有料レビューの実行、ブランチ保護やルールセットの変更、Copilot レビュー設定の削除、サービスや CLI のインストール、コミット、プッシュ。

完了条件：差分を提示し、検証結果を明記し、すべての行が依頼に基づいていること。

設定の形式

公式スキーマ https://coderabbit.ai/integrations/schema.v2.json を使用してください。設定は小規模に保ちます。

• reviews.profile はフィードバックの量を制御します。マージポリシーを強制するものではありません。
• reviews.path_instructions では、{path, instructions} 形式のエントリーと、リポジトリ相対の minimatch パターンを使用します。
• skills/**/SKILL.md、skills/**/assets/**、skills/**/references/**、skills/**/evals/**、.github/** など、追跡対象の代表的なパスをテストします。

安全ルール

• 編集する前に監査し、説明します。
• 認証情報やトークンは決して追加しません。
• UI や継承された設定が確認できない場合、有効な設定を推測しません。証拠が不足していることを報告します。
• スキーマの妥当性、パスの網羅性、レビューの完了を、別の結果から推定して主張しません。
• .coderabbit.yaml やステータスチェックだけを根拠に、レビューが実行されたと示唆しません。
• 既存のポリシーが依頼と異なる場合は、変更する前に確認します。

注意すべき兆候

次の場合は作業を止めて調査します。

• 緑色のステータスが、レビュー完了の証拠として扱われている。
• スキーマ検証の成功が、パスやガイドラインの網羅性の証拠として扱われている。
• 発見した指示が、文書化または確認された適用範囲を超えて適用されている。
• ワークフローとブランチルールの証拠がないのに、プロファイルレベルがマージの強制条件として扱われている。
• セットアップ依頼が、コメント、有料レビュー、ブランチルール、インストール、コミットにまで拡大している。
• 比較根拠なしに、リポジトリ全体のプリセット移行が行われている。

誤った理屈	成り立たない理由	必要な対応
「チェックが緑なので、CodeRabbit のレビューは完了しています。」	ステータスチェックとレビュー完了の証拠は、異なる主張です。	レビューイベント、指摘事項、プルリクエストの正確なヘッドを確認します。
「スキーマが有効なので、網羅性も十分です。」	構文上の制約だけでは、パスやガイドラインの網羅性は証明できません。	追跡対象の代表的なパスをテストし、不足があれば報告します。
「古いボットは廃止されたので、そのガイダンスは無効です。」	ガイダンスはファイル、継承された設定、UI の状態に残っている可能性があります。	削除または無視する前に、ソースと有効な設定を検索します。

出力

## CodeRabbit <audit | setup>: <repo> [PR <n> @ <head-sha>]

- Schema: valid | invalid: <error> | cannot validate: <reason>
- Effective config source: file | inherited | UI | unknown
- Review completion (PR only): verified @ <sha> | not verified: <reason>

| # | Severity | Confidence | Check | Location | Finding | Recommendation |
|---|---|---|---|---|---|---|

### Evidence gaps
- <what was not checkable and why>

### Proposed diff (setup only)

重大度：ブロッカー、高、中、低。確信度：引用可能なファイル、ドキュメント、プルリクエストイベントに基づく場合は certain、確認可能だが未検証の主張の場合は speculative。証拠のない主張は削除します。

インラインの例

reviews:
  profile: chill
  path_instructions:
    - path: "skills/**/SKILL.md"
      instructions: "Check portability, scope, and resource references."

実行例

/config-review-bot audit PR 123 at the exact head and base; report findings only
/config-review-bot set up CodeRabbit for this repository; propose and validate only the requested config changes

リソース

• CodeRabbit の設定リファレンス
• CodeRabbit のパス指示
• CodeRabbit のスキーマ
• コードガイドライン
• 自動レビューとレート制限
• CLI リファレンス
• 変更依頼のワークフロー
• 公式の CodeRabbit CLI スキル。この設定スキルとは別のものです