claude-code-auto-advisor

claude-code-auto-advisor

2つ目のモデルによってリスクを大幅に低減できるタスクでは、Claude Code に設定されたアドバイザーを自動的に呼び出します。

判断フロー

このスキルを適用する前に、次の条件を順番に確認してください。

• Claude Code で実行されていない： 停止してください。サブエージェント、ウェブ検索、別のモデル、または別のハーネス機能でアドバイザーを模倣しないでください。

• Claude Code のこのセッションにアドバイザーモデルが設定されていない、または呼び出し可能なアドバイザーツールがない： アドバイザーを呼び出さないでください。通常の検証を続け、最終的な引き継ぎに関係する場合にのみ、スキップした理由を記録してください。

• タスクがセキュリティ関連、コードレビュー、重大な影響を伴う設計、本格的な作業に入る前の複数段階にわたる上位計画の検証、リスクの高いリファクタリング、本番環境やデータに影響する作業、繰り返し発生する失敗、または複雑な完了確認に該当する： ローカルで十分な根拠を集めてから、方針を決定したり最終結論を出したりする前にアドバイザーに相談してください。references/advisor-policy.md を読んでください。

• タスクが定型的、元に戻せる、単一ステップ、一般的な計画、小規模なチェックリスト、またはローカルの根拠からすでに完全に判断できる： アドバイザーに相談しないでください。

• アドバイザーが有効かどうか不明： 実際の Claude Code ツール一覧を信頼できる情報源として優先してください。必要に応じて、保守的な設定の事前確認として python3 scripts/detect_advisor_config.py --format text を実行し、その後 references/claude-code-mechanics.md を読んでください。

クイックリファレンス

状況	対応
セキュリティ、認証、シークレット、権限、サンドボックス化、サプライチェーン、データ漏えい	初期のコンテキスト収集後、推奨事項の提示や編集を行う前にアドバイザーに相談する
コードレビュー、PR レビュー、または独立したレビューの依頼	最終的な指摘をまとめる前にアドバイザーに相談する
大規模な複数段階の実装計画、移行計画、マルチエージェントへの引き継ぎ、または影響範囲が大きい上位計画	根拠と制約を踏まえて計画を作成し、作業開始前にアドバイザーに相談する
大規模なリファクタリング、移行、並行処理、データモデル、取り消せないデプロイ、本番環境への影響	計画を確定する前に相談する。リスクが残る場合は完了前に再度相談する
信頼できる方法を2回試した後も同じエラーパターンが繰り返される	さらに推測に基づく修正を試す前に相談する
アドバイザーモデルまたはツールがない、メインモデルが未対応、アドバイザーが無効、または Claude 以外のハーネス	呼び出さないでください。ユーザーがアドバイザーの設定を依頼していない限り、設定を求めないでください
小規模な書式変更、単純なコマンド出力、明白な誤字、短く回答が定まっている質疑応答、単一ステップの計画、または一般的なタスク計画	相談しない

運用ルール

1. このスキルは Claude Code 内でのみ使用してください。現在のハーネスが Codex、Gemini CLI、Cursor、OpenCode、または不明な場合は、直ちにスキルを終了してください。
2. 現在の Claude Code セッションで呼び出し可能なアドバイザーツールがある場合、それをアドバイザーモデルが設定されていることを示す最も強いシグナルとして扱ってください。ヘルパースクリプトが確認できるのは表示可能な設定のみであり、すべてのセッション上書きを検出できるわけではありません。
3. アドバイザーが存在するというだけの理由で呼び出してはいけません。相談には、具体的な計画、レビュー、リスク、またはデバッグ上の理由が必要です。
4. 必須カテゴリでは、まず関連するファイル、差分、ログ、テスト、ドキュメント、制約を収集してください。コンテキストが不足した状態でアドバイザーを呼び出すより、後で根拠を揃えて呼び出すほうが適切です。
5. 高レベルの計画検証では、複数の依存する手順またはフェーズがあり、影響範囲が十分に大きい計画を対象にしてください。まず実際の計画を作成します。目標、フェーズ、ファイル／サブシステム、前提、リスク、ロールバックまたは中止地点、検証方法を含めてください。実装を開始する前にアドバイザーに相談してください。通常の計画、小さな ToDo リスト、次に実行するローカルコマンドの選択にはアドバイザーを使用しないでください。
6. 相談する際は、呼び出し前に通常のアシスタントテキストで、現在の不確実性を明確にしてください。隠し引数を渡そうとしないでください。Claude Code のアドバイザーは、サーバー側で会話コンテキストを受け取ります。
7. アドバイザーの助言は批判的に適用してください。ローカルの根拠と矛盾する場合は、その根拠を優先し、食い違いを説明したうえで、検証済みの方法で進めてください。
8. アドバイザーのコンテキストを充実させることだけを目的に、シークレット、認証情報、または個人データを読んではいけません。アドバイザーには会話全体とツールの結果が送られるため、機密情報を含むトランスクリプトは最小限にしてください。

読み方ガイド

必要なこと	読むもの
タスクでアドバイザーへの相談が必要かどうかを判断する	references/advisor-policy.md
Claude Code のアドバイザーのセットアップ、要件、モデルの組み合わせ、コスト、キャッシュ、障害モードを理解する	references/claude-code-mechanics.md
アドバイザーを呼び出さずにローカルの Claude Code 設定を確認する	scripts/detect_advisor_config.py

注意点

1. アドバイザーの設定はセッションに依存します。保存された advisorModel があっても、メインモデル、プロバイダー、組織の許可リスト、または無効化フラグによってブロックされている場合、現在のリクエストでアドバイザーを呼び出せるとは限りません。
2. アドバイザーはツールの結果を含む会話全体を読み取ります。別の意見を得るためだけに、機密ファイルをコンテキストに取り込まないでください。
3. 呼び出すのが早すぎると、最も有効なレビューの機会を無駄にします。レビューやセキュリティ作業では、まず実際のコードを調査してから相談してください。
4. 計画検証の対象は、複数の手順がある大規模な計画に限られます。ブレインストーミング中ではなく、計画が具体化した後に行います。通常の計画や小さな ToDo リストでは決して行いません。
5. アドバイザーは、テスト、静的解析、またはローカルの根拠の代わりにはなりません。追加の推論を行うものです。
6. アドバイザーを呼び出すタイミングは Claude Code が制御します。このスキルは適切なタイミングで相談するよう促しますが、アドバイザーが無効または未設定のセッションでは、その状態を尊重する必要があります。