dossier-collect

ドシエ収集

シードエンティティを起点に、再帰的かつ並列に調査し、グラフ構造のドシエを作成します。

使用する場面

シード（ユーザー名、ファイル、シンボル、ADR-id、URL、または概念）があり、特定の質問への回答ではなく、主張ごとの出典を記録しながら、つながりのあるエンティティをすべて外側へと広げて見つけたい場合に使用します。

具体的な質問には deep-research を使用してください。複数ステップの計画には goal-plan を使用してください。

手順

1. シードの種類を判定する — 次のいずれかに分類します。username（ハンドル）、file（パス）、symbol（コード識別子）、adr（ADR-NNN）、url、または concept（自由形式のテキスト）。
2. ソースを選ぶ — シードの種類に対応するソースマトリックスを参照します。デフォルトでは該当するものをすべて使用します。
3. 軌跡を開始する — タスク dossier:<slug> を指定して mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-start を呼び出します。
4. ラウンド 0 で一括検索する — すべてのソースへのクエリを 1 つのメッセージで実行します。例：
   • username の場合：WebSearch、github.com/ に対する WebFetch、mcp__plugin_ruflo-core_ruflo__memory_search_unified
   • adr の場合：ADR ファイルへの Read、参照箇所の Grep、namespace adr での mcp__plugin_ruflo-core_ruflo__memory_search
   • symbol の場合：Grep、Glob、mcp__plugin_ruflo-core_ruflo__embeddings_search
5. エンティティを抽出する — 各ヒットからエンティティ（人物、リポジトリ、ファイル、ADR、URL、用語）を抽出します。軽量な正規表現とヒューリスティクスを使用し、曖昧な場合を除いて LLM による抽出は行いません。
6. 重複を除去する — ドシエにすでに存在するエンティティを除外します。--exact が未設定の場合は、既存のノードとの埋め込みコサイン類似度が 0.92 以上のエンティティも除外します。
7. ラウンド k の再帰処理 — 新しい各エンティティについて（ソースごとに --max-breadth 件まで）、深さが --max-depth 以上になるか予算を使い切るまで手順 4 を繰り返します。
8. 集約する — { nodes, edges } グラフを構築します。各ノードには { id, type, attrs, sources: [...] } が含まれます。各エッジには { from, to, kind, source, confidence } が含まれます。
9. 成果物を生成する：
   • <slug>.md — エグゼクティブサマリー、エンティティテーブル、mermaid グラフ、出典を示す脚注
   • <slug>.json — 機械可読なグラフ
   • デフォルトの場所：v3/docs/examples/dossiers/<slug>/
10. 保存する — namespace dossier、key <slug> で mcp__plugin_ruflo-core_ruflo__memory_store を呼び出します。
11. 軌跡を終了する — 成功ステータスを指定して mcp__plugin_ruflo-core_ruflo__hooks_intelligence_trajectory-end を呼び出します。

出力スキーマ（JSON）

{
  "seed": "ruvnet",
  "seedType": "username",
  "depth": 2,
  "truncated": false,
  "generatedAt": "ISO-8601",
  "nodes": [
    { "id": "ruvnet", "type": "username", "attrs": { "...": "..." }, "sources": ["WebSearch", "github.com"] }
  ],
  "edges": [
    { "from": "ruvnet", "to": "ruflo", "kind": "owns", "source": "github.com", "confidence": "high" }
  ],
  "stats": { "nodesByType": {}, "sourcesUsed": [], "tokensSpent": 0 }
}

予算管理

• --budget-usd が設定されている場合は、軌跡を通じて概算コストを追跡します。予算を使い切った場合は、truncated: true と、引き続き処理待ちのエンティティを含む部分的なドシエを出力します。
• 展開は BFS のみで行います。ラウンド k を完了してからラウンド k+1 に進みます。
• 何も記録せずに切り詰めてはいけません。スキップした内容は必ず明示し、記録します。

例

/ruflo-goals:dossier-collect ruvnet
/ruflo-goals:dossier-collect ADR-097 --max-depth 1
/ruflo-goals:dossier-collect "src/memory/hnsw.ts" --sources codebase,git,memory
/ruflo-goals:dossier-collect "ruflo-goals" --max-breadth 5 --budget-usd 1