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 検索・一般的な質問への説明。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 19.6 KB |
| heuristics/advisory-consultation.md | markdown | 8.7 KB |
| heuristics/clarifying-questions.md | markdown | 3.5 KB |
| heuristics/db-characteristics.md | markdown | 7.2 KB |
| heuristics/evidence-grading.md | markdown | 7.9 KB |
| heuristics/failure-modes.md | markdown | 13.7 KB |
| heuristics/query-expansion.md | markdown | 4.6 KB |
| heuristics/source-selection.md | markdown | 20.0 KB |
| reference/01-core-workflow.md | markdown | 10.9 KB |
| reference/02-source-and-query.md | markdown | 14.8 KB |
| reference/03-evidence-and-output.md | markdown | 29.6 KB |
| reference/04-ephemeral-web-discovery.md | markdown | 4.0 KB |
| reference/regional-public-library-research.md | markdown | 11.7 KB |
| scripts/plan-regional-library-search.mjs | script | 16.0 KB |
| workflows/bibliography-lookup.md | markdown | 5.7 KB |
| workflows/field-orientation.md | markdown | 8.3 KB |
| workflows/fulltext-page-lookup.md | markdown | 16.0 KB |
| workflows/historical-term-search.md | markdown | 4.8 KB |
| workflows/image-illustration-search.md | markdown | 3.9 KB |
| workflows/research-guide-lookup.md | markdown | 8.7 KB |
| workflows/topic-literature-review.md | markdown | 8.1 KB |
heuristics/clarifying-questions.md
View on GitHub# 問い返しガイダンス(clarifying-questions)
このファイルでは「計画確認」と「問い返し」を区別する。どちらも検索前に行うが、目的が異なる。
---
## 1. 調査計画の確認
Skill が動いている場合、検索前に調査計画を提示してユーザーの確認を取る。単純な所蔵確認・書誌確認では短くてよいが、未知の文献・資料・調べ方を探索する調査では、レファ協・NDL リサーチ・ナビを参考にした計画を示す。
MCP ツールを呼ぶのは確認後のみ。
source の自然言語読み替えは MCP ツール側(jp_lit_search の description)に定義されている。
### 提示フォーマット
使う source・検索語・理由を示す。ユーザーが追加・変更を指示できる余地を作る。
```
以下の source で調べます:
- cinii_articles / ndl_articles(論文)
- ndl_catalog / cinii_books(図書)
検索語: 「〇〇」「△△」(表記ゆれ含む)
よろしければ開始します。追加・変更があればお知らせください。
```
scope が明らかに小さい依頼(単一の書誌確認など)は 1 行で示してもよい:
```
単純な所蔵確認として、ndl_catalog で「○○」を確認します。よいですか?
```
ユーザーが「もっと広く」と言えば source を追加し、「まずざっくりで」と言っても新規テーマでは `ndl_search` + `japan_search` を既定セットにする方向で計画を更新する。
---
## 2. 問い返し(intent・資料種別が不明な場合のみ)
### 前提:このスキルが動いている時点で文献調査は確定
「文献調査なのか一般説明なのか」を確認する必要はない。問い返しは intent や資料種別が判断できないときのみ行う。問い返しは最小限(1〜2 問)にとどめる。
### 問い返しが必要なケース
| 状況 | 確認すべきこと |
|------|--------------|
| 資料種別が不明 | 「論文を探していますか、図書(単行本)ですか、一次資料(当時の文書・史料)も含めますか?」 |
| 時代が不明 | 「対象の時代はいつ頃ですか?(近世・近代・現代など)」 |
| 用途が不明 | 「研究・論文執筆用ですか、それとも概要把握が目的ですか?」 |
| 入手可否の優先度が不明 | 「すぐ読める資料(オンライン公開)を優先しますか、所蔵確認だけでよいですか?」 |
| 専門 DB が有効か不明 | 「〇〇の専門 DB(例: nihu_bridge)まで含めますか、一般的な DB で十分ですか?」 |
### 問い返しの書き方
- 一度に複数の質問をしない(1〜2点まで)
- 選択肢を示す(「論文ですか、図書ですか」のように)
- 「わからなければそのまま進めます」と添えて圧をかけない
例:
```
少し確認させてください。
対象は **論文・雑誌記事** ですか、それとも **図書(単行本)や一次資料(史料)** も含めますか?
わからない場合はそのまま進めます。
```
### 問い返し不要のケース
- タイトル・著者・出版年が具体的に分かっている → bibliography_lookup として実行
- 「全文検索して」「デジコレで探して」→ fulltext_page_lookup として実行
- 資料種別・対象が依頼の文言から明らかに読み取れる → 確認なしで計画提示へ進む
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |