Skip to content

itarunnn/jp-lit-mcp / skills/jp-lit-research

jp-lit-research

Verified

日本語人文社会系文献調査スキル。jp-lit MCP サーバーを使って NDL・CiNii・J-STAGE・IRDB・JDCat・NIHU Bridge・国会会議録などを横断検索し、 書誌確認・所蔵調査・テーマ文献探索・古語表記ゆれ検索・デジコレ全文OCR・図版検索を行う。 「文献DBで調べて」「文献DBを始めます」など、文献DB という起動語を明示した文献調査依頼で使用する。 一度発火したらセッション中は継続して調査を進める。 SKIP: 「調べて」単体・API ドキュメント調査・Web 検索・一般的な質問への説明。

reference/01-core-workflow.md

View on GitHub
# jp-lit-research core workflow

## 役割

- `MCP` は検索・取得に徹する
- この Skill は調査戦略、source 選択、検索語展開、典拠評価、結果整理を担う
- 1 回の検索で終わらず、結果を見て次の query や次の source を決める対話的な探索ループを担う

## 基本フロー

1. 依頼を intent に分類する
2. `jp_lit_start_session` を呼び、返された調査用 `session_id` を保持する。同じ調査の継続なら既存IDを引き継ぐ
3. 原則として、レファ協・NDL リサーチ・ナビを参考に調査前情報収集を行う。レファ協toolには同じ `session_id` を渡す。NDL リサーチ・ナビは Web 検索で該当ページを探し、固有名詞 query が不発なら抽象度を上げた調べ方 query を試す
4. `ndl_search` + `japan_search` + 調査前情報収集で示唆された source を初手実行 source として、検索語の案を作る
5. 検索方針をユーザーに提示して確認を取る
6. 同じ `session_id` を `jp_lit_update_session_trace` に渡して調査目的と source plan を残す
7. 同じ `session_id` を明示して最小限の source / query で検索する
8. 結果を読み、同じ `session_id` を `jp_lit_annotate_session.trace` に渡して検索試行・採否理由・本文確認範囲を残す
9. 必要なら同じ `session_id` で query / source を変えて再検索する
10. 選別過程を明示して報告する

## 明示的な調査セッション

- `session_id` は複数回の tool call を一つの調査案件へまとめるアプリケーション側 handle であり、MCP transport の接続 ID ではない
- 検索・取得・照合・典拠補助などの cached tool と、annotation・trace・session export には対象の `session_id` を毎回渡す
- `cache_key` は個々の検索結果・取得結果を指す。同じ cache を複数セッションから再利用しても、利用記録は明示された各セッションへ残る
- `current.json` はローカル互換用 mirror であり、tool 呼び出し先を暗黙に選ぶ根拠として使わない

## 検索前確認と継続調査

- 新規テーマでは、検索 MCP を呼ぶ前に短い調査方針を提示し、ユーザー確認を取る
- `jp_lit_search_guides_manuals` / `jp_lit_search_guides_cases` など、調査計画を立てるための情報収集は確認前に使ってよい
- すでに同一セッションで文献DB調査が発火しており、ユーザーが「同様に」「次は近代で」などの継続指示を出した場合は、既定方針を 1〜2 文で宣言して検索を続けてよい
- 継続調査でも、最終回答の `検索概要`、`今回の確認範囲`、`調査ログ` は省略しない

## 複数クエリ前提の運用

- 1 回の返答の裏で複数回 `jp_lit_search` などを呼ぶことがある
- 返答時には、それが単発検索の結果ではなく探索ループの要約であることを明示する
- 可能なら各検索について次を示す
  - 何を確かめるための検索か
  - どの source / query を使ったか
  - `total` のうち何件取得したか

## 検索後の二次操作

- 「今の検索を並び替えて」「この条件で絞って」系の依頼は、まず `jp_lit_refine_results` を使う
- candidate result は `jp_lit_search`、`jp_lit_search_fulltext`、`jp_lit_record_ndl_browser_search` の3種類。後者は browser agent の観測値を同じ `session_id` の local cache/session へ保存するだけで、MCP 本体はブラウザ・ログイン・外部通信を行わない
- `jp_lit_refine_results` はこれらのローカルキャッシュ済み結果を再処理するため、upstream 再検索より速く、追加ノイズも増やしにくい。同じ canonical `source` + `source_id` は来歴を保って統合する
- 対象は `cache_key`、`cache_keys`、`result_ref`、`result_refs`、`session_id` のいずれか1つだけで明示する。複数 tool の正本は `{ tool, cache_key }` の `result_refs` とする。`include_enrichment=true` では、対象 `session_id` または `enrichment_cache_keys` も明示する
- `jp_lit_refine_results` で足りない場合のみ、query/source を変えた再検索へ進む
- cached tool の `cache.hit=true` は保存済み結果の再利用を意味する。返答では `cache.saved_at` と、上流 API へ再検索していないことを明示する
- 最新データが必要な場合だけ `force_refresh=true` を使う。通常の継続調査・再整理では明示リフレッシュしない
- 既存結果の再整理では `total_before` / `total_after`、適用条件、表示件数を示す
- export や annotation を求められた場合は、`selected_items.note` に個別候補の理由、`notes` に検索全体の選別理由を残す
- 調査経過の保存は `jp_lit_update_session_trace` を使う。`source_plan_count` などの count は追加件数ではなく更新後の合計件数として扱う

## Web 補助確認

- 文献DB調査では Web は主経路にしない。NDL / CiNii / J-STAGE / IRDB などで候補集合を作る
- 例外として、NDL リサーチ・ナビは調査前情報収集のために Web 検索で確認する。ここで得た情報は調査ルートの材料であり、資料本文や書誌確定とは分ける
- Web は、出版社・団体の性格、著者属性、本文入口、公開PDFの所在、DB外の専門的反応を補う場合に限る
- ユーザーが Web 調査を明示した場合、またはDB上で専門的書評・批判・応答の存在が示唆された場合だけ、Webで書評や批判を広げて探す
- Web由来情報は `根拠: Web補助確認` とし、文献DB由来の書誌・要旨・目次・本文確認と混同しない

## intent

- `bibliography_lookup`
- `topic_literature_review`
- `historical_term_search`
- `fulltext_page_lookup`
- `image_illustration_search`
- `research_guide`

## 調査前情報収集

調査を始める前に、まずレファ協と NDL リサーチ・ナビを参考にして調査計画を立てる。ここでの「調査」は、未知の文献・資料・調べ方を探索する依頼を指す。

調査前情報収集では、レファ協から類似質問・調査プロセス・参考資料を、リサーチ・ナビから分野別の調査順序・見るべき索引や参考図書を拾い、`first_pass_plan` に反映する。リサーチ・ナビは Web 検索で `site:ndlsearch.ndl.go.jp/rnavi <固有名詞または主題語>` を試し、不発なら調査類型へ抽象化する。参考図書・専門索引・有料 DB が示唆された場合は、無料オンラインで完結しない可能性を前提に `参考書誌確認` / `要有料DB確認` として計画と最終回答に残す。

例外として、タイトル・著者・ISBN・NCID・DOI などが明確で、単純な所蔵確認・書誌確認だけを行う場合は省略してよい。省略した場合でも、0 件・ノイズ過多・初出/掲載号/一般誌記事へ分岐した時点で、レファ協・リサーチ・ナビに戻って計画を作り直す。

intent 別の扱い:

- `research_guide`: 常に実行
- `topic_literature_review`: 実行
- `historical_term_search`: 実行
- `bibliography_lookup`: 単純な所蔵・書誌確認は省略可。初出、掲載号、雑誌記事、同定困難、0 件時は実行
- `image_illustration_search`: 美術・文化財・地域資料なら実行
- `fulltext_page_lookup`: 省略

## 長期調査の rolling checkpoint

長期調査、独立した調査線が複数ある調査、または compaction 後に判断基準がずれやすい調査では、一定間隔で rolling checkpoint を作る。checkpoint は final answer ではなく、再開・分担・統合判断のための作業状態である。

rolling checkpoint は、次の時点で作る:

- source や時代区分を切り替える前
- 採用候補・保留候補・検索ヒットのみ候補が増えた時
- 本文確認済み / 目次確認 / 書誌確認 / 未確認の区別が変わった時
- サブエージェントまたは sequential 担当単位へ分ける前
- compaction や別スレッド再開が見込まれる時

サブエージェント機能がない環境では、同じ単位で sequential に処理し、各単位ごとに handoff report を残す。環境固有の呼び出し API に依存しない。主エージェントが統合判断を持ち続ける。

## 会話運用

- 生の検索結果や OCR payload を会話へ大量に貼り付けない
- 内部保存した cache / session を原本とし、会話には要点と判断だけを残す
- session trace は主エージェントの文脈維持にも使う。検索計画、source 選択ログ、検索試行ログ、採用/保留/除外理由、未確認事項、次に見る source を残す
- cache は検索結果・取得 payload の保管場所、session trace は検索試行と判断の機械寄り記録、調査トレース報告 / handoff report は主エージェントが読む人間可読の引き継ぎ報告として分ける
- 断定、引用、candidate の格上げ、競合解消、export 作成時だけ原本へ戻る
- 通常の探索ループ(source 選択、検索語展開、候補判断、次 query の決定)は主エージェントが文脈を持って統合する
- 独立した調査線が 2 本以上ある場合は、サブエージェント分担をデフォルト寄りに検討する。例: `NDL/CiNii の書誌・所蔵確認`、`Japan Search/文化資源確認`、`専門領域 Web 補助確認`、`地域公共図書館・専門資料室導線`
- サブエージェントに任せる場合は、担当範囲と対象 `cache_key` / `session_id`、使ってよい source、調査トレース報告の出力形式を固定する
- 各サブエージェントは自分の担当範囲について、検索試行、採用/保留/除外理由、本文確認範囲、未確認事項、次アクションを trace に残し、主エージェントへ brief summary ではなく調査トレース報告 / handoff report を返す
- 調査トレース報告は current report として更新してよい。追加プロンプトで訂正・追補が入った場合は、本文を最新版に直し、末尾の `変更履歴` に何を直したかを残す
- 主エージェントは handoff report を先に読み、必要な場合だけサブエージェントの trace / cache に戻る。重複・競合・優先度を整理し、最終判断と回答を統合する single writer になる
- 自然文要求は「最新化 > 削除 > 一覧 > 再抽出 > 通常検索」の順でツールへルーティングする
- `saved_on` の `today` / `yesterday` / `last_7_days` はサーバー側で `Asia/Tokyo` 基準に解決されるため、エージェント側で日付文字列へ展開しない

## 参照

- `02-source-and-query.md`
- `03-evidence-and-output.md`
- 旧詳細資料: `workflows/` / `heuristics/`
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall