deep-dive について
deep-dive は、問題を調査してから対応策を定めるスキルです。複数のトレース調査を並行して行い、その結果をインタビューに反映して、仕様から実行方法へつなげます。
主な機能
- 013つの調査仮説の生成
- 02トレースレーンの並行実行
- 03証拠と不明点の比較
- 04調査結果のインタビューへの反映
- 05トレース所見付き仕様の保存
活用シーン
- 01バグの根本原因の特定
- 02要件定義前の改善案の調査
- 03曖昧な問題の実行可能な仕様化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ zereight/ gitlab-mcp --skill deep-diveインストール後、Claude Code で/deep-diveを入力して読み込まれたか確認します。
詳細
詳細調査
2 段階のパイプラインをオーケストレーションします。まず、なぜ何かが起きたのかを調査し(trace)、次にそれに対して何をすべきかを定義します(deep-interview)。trace の調査結果は、3 点の注入を通じてインタビューに反映されます。
パイプライン
deep-dive → ralplan(合意形成による精緻化)→ omg-autopilot(実行)
使用する場面
- ユーザーに問題はあるものの、根本原因がわからない場合
- バグ調査:「何かが壊れたので、原因を突き止めたい」
- 機能の検討:「X を改善したいが、まず現状を理解したい」
使用しない場面
- 根本原因がすでにわかっている場合 →
/deep-interviewを使用 - 具体的で明確な依頼の場合 → そのまま実行
- 要件がなく、調査だけを行う場合 →
/traceを使用
フェーズ
フェーズ 1:初期化
- 問題を解析し、既存プロジェクトか新規プロジェクトかを判定
- 3 つの trace レーンの仮説を生成(コードパス、設定/環境、測定/アーティファクト)
フェーズ 2:レーンの確認
仮説をユーザーに提示し、確認してもらいます(1 ラウンド)。
フェーズ 3:trace の実行
@tracer エージェントを使って、3 つのトレーサーレーンを並行して実行します。
- 各レーン:裏付ける証拠、反証する証拠、重要な不明点、仮説を判別するための調査
- 有力な仮説間で反論を行うラウンド
- 収束を検出
.omc/specs/deep-dive-trace-{slug}.mdに保存
フェーズ 4:trace の情報を反映したインタビュー
deep-interview のプロトコルに、次の 3 つの上書きを適用します。
- initial_idea の拡充:trace で最も有力とされた説明を含める
- codebase_context の置き換え:trace の統合結果を使用する(再調査を省略)
- 質問キューへの注入:各レーンの重要な不明点を最初の質問にする
trace の確信度が低い場合、不確かな結論は注入せず、すべての不明点を質問として使用します。
フェーズ 5:実行への橋渡し
deep-interview と同じ選択肢を使用します。ralplan → omg-autopilot(推奨)、omg-autopilot、ralph、team、またはさらに精緻化します。
出力
仕様は .omc/specs/deep-dive-{slug}.md に保存され、「Trace Findings」セクションが追加されます。
コメント
Markdown 対応