ln-022-researchgraph について
ln-022-researchgraphは、プロジェクトの研究グラフを検索・監査するスキルです。仮説、目標、エビデンス、ベンチマーク実行の追跡に向け、質問に応じたグラフ操作と手動ファイル読み込みの代替手順を備えています。
主な機能
- 01研究インデックスの検証・再構築
- 02仮説と目標の確認
- 03エビデンスとベンチマーク実行の検索
- 04系譜と目標ツリーの追跡
- 05不足項目と研究の変化の監査
- 06研究マップとキャンバスのエクスポート
活用シーン
- 01仮説の状態と目標の準備状況の確認
- 02ベンチマークのエビデンスとソースのレビュー
- 03関連付けやプロジェクトメタデータの不足箇所の特定
- 04研究グラフマップの生成
MCP 対応
hex-research-mcpで研究ファイルをインデックス化・検索し、利用可能な場合はhex-researchの操作を使います。MCPを利用できない場合は、手動でファイルを読み込む手順に切り替えます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/ln-022-researchgraphを入力して読み込まれたか確認します。
同梱ファイルreferences/researchgraph_mcp_usage.md
詳細
パス： ファイルパスは、このスキルのディレクトリからの相対パスです。
リサーチグラフ
種類： スタンドアロンユーティリティ
カテゴリ： 0XX 開発環境
hex-research-mcp を通じて、正規のプロジェクトリサーチファイル（仮説、目標、タスク、ソース、ソースライブラリエントリ、ベンチマーク実行マニフェスト、エビデンスリンク、導出された目標指標、系譜、生成されたリサーチマップ、監査上の不足）をインデックス化してクエリします。
必読資料
必ず読む資料： references/researchgraph_mcp_usage.md を読み込みます。
入力
| 入力 | 必須 | ソース | 説明 |
|---|---|---|---|
project_path | はい | args または CWD | リサーチグラフファイルを含むプロジェクトのルート |
command | いいえ | args | 特定のアクション：audit、inspect H##、goal G##、runs、evidence、lineage、progress、proposed、canvas |
使用するタイミング
プロジェクトに次のいずれかがある場合、このスキルを使用します。
docs/hypotheses/*.mddocs/goals/*.mdbenchmark/runs/*/manifest.yaml
リサーチの状況、現在または保留中の仮説、目標の準備状況、ベンチマークのエビデンス、ソースの品質、エビデンスの深さ、提案の準備状況、実装上の不足、ドリフト、フィールド単位の変更、または視覚的／生成されたリサーチマップについてユーザーから質問された場合に使用します。
コードシンボルの所有関係、呼び出しグラフ、参照、編集による影響範囲には、このスキルを使用しないでください。コードの意味に関する質問には、ln-021-codegraph またはホストの hex-graph ポリシーを使用します。
MCP の利用可否
利用可能な場合は hex-research を使用します。利用できない場合は、分割されたリサーチファイルを Glob/Grep/Read で手動で読み、直接確認したファイルのエビデンスに基づいて回答し、信頼度が低下していることを明記します。
STALE は、対応が必要なグラフ上の負債または不足しているプロジェクトメタデータとして扱い、ツールの失敗とはみなしません。verify_index の INVALID は、書き込み／インデックス操作が失敗しない限り、診断情報として扱います。
ワークフロー
フェーズ 1：グラフのレイアウトを検出する
正規のレイアウトを確認します。
docs/hypotheses/*.mddocs/goals/*.mdbenchmark/runs/*/manifest.yaml
いずれも存在しない場合は、処理を中止し、プロジェクトにまだリサーチグラフがないことを報告します。仮説や目標を捏造しないでください。
フェーズ 2：検証またはインデックス化する
まず読み取り専用で実行します。
verify_index({ path: "{project_path}" })
インデックスが存在しない、古くなっている、明示的に要求された、またはタスクで最新のグラフ状態が必要な場合に限り、再構築します。
index_hypotheses({ path: "{project_path}" })
ローカルインデックスは、対象プロジェクトの .hex-skills/researchgraph/ に保存されます。
フェーズ 3：意図に応じて振り分ける
| ユーザーの意図 | ツール |
|---|---|
| 現在、保留中、却下、混在、未着手の仮説 | find_hypotheses |
H## を調べる | inspect_hypothesis |
G## または目標の状況を調べる | inspect_goal |
| エビデンス、ソース、ベンチマークの証明 | find_evidence |
| 対象を絞った、または包括的なベンチマーク実行 | find_runs |
| 親／子の仮説チェーン | trace_lineage |
| グラフのハブ、切断されたノード、構造 | analyze_topology |
| 不足している目標やソース、タスクの不足、ドリフト | audit_orphans |
| 目標ツリー | trace_goal_tree |
| 目標の準備状況、導出指標、指標の網羅状況 | inspect_goal、audit_goal_alignment |
| ソースの品質またはエビデンスの深さ | inspect_hypothesis、find_evidence、analyze_proposed |
| 現在の差分における変更されたリサーチファイルとフィールド単位の差分 | analyze_progress |
| 次に提案する仮説の準備状況 | analyze_proposed |
| JSON Canvas のエクスポート | export_canvas |
生成された docs/research-map.md のエクスポート | export_research_map |
フェーズ 4：結果を提示する
次の内容を報告します。
- ツールの状態（
OK、STALE、INVALID、ERROR） - ID を含む主要な仮説／目標／実行
- 対応が必要なグラフ上の負債を、ツールの失敗とは分けて提示
- グラフがより絞り込んだ次の質問を示している場合は、後続のツール呼び出し
export_canvas と export_research_map では、まずドライランを実行します。ドライランの出力が有用で、ユーザーがファイルを要求した場合にのみ書き込みます。分割ファイルを正規の情報源として扱います。生成された research-map.md は、手動管理する第二の情報源ではありません。
手動フォールバック
MCP を利用できない場合：
- まず
docs/goals/*.mdとdocs/hypotheses/*.mdのフロントマターを読みます。 - H/G ID またはステータスで絞り込んでから、
benchmark/runs/*/manifest.yamlを読みます。 - 広範囲をスキャンするより、正確な ID（
H04、G1）を優先します。 - 系譜、トポロジー、ドリフトに関する調査結果は手動による近似であることを明記します。
完了の定義
- グラフのレイアウトを検出した、または存在しないことを報告した
- インデックスを検証した、または必要に応じて再構築した
- ユーザーの意図を、関連性の最も高い最小限のツールに振り分けた
-
STALE／グラフの負債を、MCP／ツールの障害と区別した - MCP を利用できなかった場合、手動フォールバックの信頼度を明記した
- キャンバスへの書き込み前にドライランを実行した
バージョン： 0.1.0 最終更新日： 2026-05-08