search-drill-iterate は何をしますか？
サブエージェントによる反復的深層リサーチ。各反復は、ドキュメントの構造化セクションを解析し、最も価値の高いギャップを狙って前回の結果を基に構築されます。
使用タイミング
- トピックに関する深い / 徹底的な / 網羅的な調査
- 研究ドキュメントの作成または改善
- 既存の研究ファイルへの追加パス実行
入力
| 入力 | 必須 | 説明 |
|---|
| トピック | はい | 調査対象 |
| 研究ドキュメント | いいえ | 既存ドキュメントへのパス（存在しない場合は作成） |
| 反復回数 | はい | 実行するパス数 |
動作の仕組み
- オーケストレーターが入力を受け取り、
templates/pass.md のテンプレートを埋めます。
- 反復ごとに、埋められたテンプレートを使用してサブエージェントが起動されます。
- サブエージェントはドキュメントを読み込み、スキーマセクションを解析し、ギャップを調査し、ドキュメントを更新します。
- 次のサブエージェントは前回の続きから開始します — ドキュメントが唯一の引き継ぎ情報です。
ドキュメントスキーマ
すべての研究ドキュメントは以下のスキーマに従います。サブエージェントテンプレートは、各エージェントがこのスキーマを解析・更新する方法を教えます。
---
title: ...
topic: ...
created: ...
last-updated: ...
pass: N
status: draft | complete
---
## 発見
サブトピックごとに整理された調査内容。コア出力。サブエージェントは
追加、拡張、洗練を行います — 以前の発見を削除することはありません。
## 調査済みパス
実行された検索とその結果のログ。サブエージェントは検索の前に
これを必ず確認し、再調査を避けます。
- `<クエリまたはアプローチ>` → <結果>
## 決定ログ
調査中に行われた選択とその根拠。将来のパスが、なぜ特定の
優先順位が付けられたか、または優先順位が下げられたかを理解するのに役立ちます。
- [パス N] <決定> — <根拠>
## 未解決の質問
埋めるべきギャップ。各エントリには試行された内容のコンテキストがあります。
真に回答不能なギャップは、UNFILLABLE: <理由> とマークされます。
これらのセクションが重要な理由
| セクション | 目的 |
|---|
| 発見 | 実際の調査 — 読むべき内容 |
| 調査済みパス | 再調査の防止 — ラウンドの無駄遣いの最大要因 |
| 決定ログ | 推論を保持し、将来のパスが情報に基づいたトレードオフを行えるようにする |
| 未解決の質問 | 引き継ぎ — 次のパスにどこに集中すべきかを正確に伝える |
テンプレートのプレースホルダー
| プレースホルダー | 説明 |
|---|
<RESEARCH_FILE> | 研究ドキュメントの絶対パス（存在しない場合は作成される） |
<TOPIC> | 平易な言葉で書かれた調査トピック |
<SCOPE> | スコープ内の内容 |
<EXCLUSIONS> | スコープ外の内容 |
<RESEARCH_QUESTIONS> | 優先順位付けされた調査質問 |
ファイル
SKILL.md このファイル
templates/pass.md サブエージェントプロンプトテンプレート（すべての反復で共通）
docs/anti-duplication.md 再調査を防止するルール
docs/logging-markers.md 監査とキャリブレーションのための構造化マーカー
examples/example-output.md ドキュメントスキーマを実際に示す例