mcpField
D
deep-dive

deep-dive

github.com/zereightエージェントワークフロー2.1k58 回インストール今日更新
リポジトリ

deep-dive について

deep-dive は、問題を調査してから対応策を定めるスキルです。複数のトレース調査を並行して行い、その結果をインタビューに反映して、仕様から実行方法へつなげます。

主な機能

  1. 013つの調査仮説の生成
  2. 02トレースレーンの並行実行
  3. 03証拠と不明点の比較
  4. 04調査結果のインタビューへの反映
  5. 05トレース所見付き仕様の保存

活用シーン

  1. 01バグの根本原因の特定
  2. 02要件定義前の改善案の調査
  3. 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:初期化
  1. 問題を解析し、既存プロジェクトか新規プロジェクトかを判定
  2. 3 つの trace レーンの仮説を生成(コードパス、設定/環境、測定/アーティファクト)
フェーズ 2:レーンの確認

仮説をユーザーに提示し、確認してもらいます(1 ラウンド)。

フェーズ 3:trace の実行

@tracer エージェントを使って、3 つのトレーサーレーンを並行して実行します。

  • 各レーン:裏付ける証拠、反証する証拠、重要な不明点、仮説を判別するための調査
  • 有力な仮説間で反論を行うラウンド
  • 収束を検出
  • .omc/specs/deep-dive-trace-{slug}.md に保存
フェーズ 4:trace の情報を反映したインタビュー

deep-interview のプロトコルに、次の 3 つの上書きを適用します。

  1. initial_idea の拡充:trace で最も有力とされた説明を含める
  2. codebase_context の置き換え:trace の統合結果を使用する(再調査を省略)
  3. 質問キューへの注入:各レーンの重要な不明点を最初の質問にする

trace の確信度が低い場合、不確かな結論は注入せず、すべての不明点を質問として使用します。

フェーズ 5:実行への橋渡し

deep-interview と同じ選択肢を使用します。ralplan → omg-autopilot(推奨)、omg-autopilot、ralph、team、またはさらに精緻化します。

出力

仕様は .omc/specs/deep-dive-{slug}.md に保存され、「Trace Findings」セクションが追加されます。

コメント