Skip to content

知らない分野を、原文にたどりつくまで芋づる式に掘る Claude Code のスキル

Python

日本語の監査: yomiyasu 2.4.0 で README・CHANGELOG・SKILL.md・theory.md・画面の文言を見直した

MaryCache74543d9ae77a
diff --git a/CHANGELOG.md b/CHANGELOG.md
index dcda117..d175635 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,18 +1,18 @@
# 変更履歴
-imozuruの版ごとの変更を記録します。
-書式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) に、版の番号は [セマンティック バージョニング](https://semver.org/lang/ja/) に沿っています。
+imozuruのバージョンごとの変更を記録します。
+書式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) に、バージョン番号は [セマンティック バージョニング](https://semver.org/lang/ja/) に沿っています。
-プラグインの `plugin.json` には版の番号を書いていません。
+プラグインの `plugin.json` にはバージョン番号を書いていません。
mainにコミットが入るたびに、使っている人へ更新が届きます。
-版の番号はまとまった変更の区切りを示すために、この変更履歴とgitのタグ(`v2.0.0` など)だけに付けます。
+バージョン番号はまとまった変更の区切りを示すために、この変更履歴とgitのタグ(`v2.0.0` など)だけに付けます。
## [未公開]
## [2.0.0] - リリース前
1.0のimozuruは原文を集め、抜き書きとして見せるところまでを受け持っていました。
-AIの判断能力は、形式知・ノウハウを収集することで強化されます。
+AIの判断能力は形式知・ノウハウを収集することで強化されます。
原文に書かれた形式知・ノウハウを集めて、AIの判断の材料にすることが、1.0までの主な目的でした。
2.0のメジャーアップデートでは受け持つ範囲を広げ、人間が見ることに重点を置いて強化しました。
@@ -57,7 +57,7 @@ AIの判断能力は、形式知・ノウハウを収集することで強化さ
- iPhoneとSafariでは、文書だけのページを開いてから印刷の画面を出します。ダッシュボードの枠の中の文書を刷ろうとすると、画面全体が刷られるためです。
- 抜き書き・詳細レポート・map.md・log.mdは、ブラウザの印刷でも同じ形で刷れます。
- **感想・要望を送る**
- - 右上のボタンから、作者のGoogleフォームへ感想・要望・不具合を送れます。送るのは書いた内容とimozuruの版・ブラウザの種類だけで、調査の題や中身は送りません。
+ - 右上のボタンから、作者のGoogleフォームへ感想・要望・不具合を送れます。送るのは書いた内容とimozuruのバージョン・ブラウザの種類だけで、調査の題や中身は送りません。
- 送り先は環境変数 `IMOZURU_FEEDBACK_FORM` で差し替えられ、`off` で消せます。
- **文書だけの書き出し**(`dashboard.py --bundle`)
- ページと、各トピックの詳細レポート・抜き書き・map.md・log.mdだけを別の場所へ書き出します。原文(`sources/`)は含めません。
@@ -79,7 +79,7 @@ AIの判断能力は、形式知・ノウハウを収集することで強化さ
- 場 → 媒体
- 古い言葉で書いた `extracts.json` もそのまま読めます。
- 全角の「#」「:」などを含む壊れたURLが1本あっても、ダッシュボード・詳細レポート・md の表示と取得が止まらないようにしました。
-- 原文のリンクは、HTMLでもPMCのXMLでも http(s) のものだけを残します。
+- 原文のリンクはHTMLでもPMCのXMLでも http(s) のものだけを残します。
- 原文の保存がPDFと文字起こしの2つ目で失敗したときは、前の原文に戻します。
- ページの書き出しの一時ファイルを、毎回別の名前で作るようにしました。
- 抜き書きのページで、英語の引用に英語の言語指定を付けました。読み上げと書体の選択が英語として行われます。
@@ -87,9 +87,9 @@ AIの判断能力は、形式知・ノウハウを収集することで強化さ
## [1.0.0] - 2026-10-21
-原文を集め、抜き書きとして見せる版です。
+原文を集め、抜き書きとして見せるバージョンです。
形式知・ノウハウを収集して、AIの判断能力を強化することを目的にしています。
-最初の公開版(2026-10-13)から、利用者のイシューと外部のレビューで直した分までをまとめて1.0.0とします。
+最初に公開したバージョン(2026-10-13)から、利用者のイシューと外部のレビューで直した分までをまとめて1.0.0とします。
### 主な内容
diff --git a/README.md b/README.md
index c5dd641..c228f7c 100644
--- a/README.md
+++ b/README.md
@@ -10,12 +10,12 @@
imozuruは知らない分野を原文にたどりつくまで芋づる式に掘るClaude Codeのスキルです。
Batesのberrypicking、Ellisの探索行動のモデル、Kuhlthauの探索過程の研究など、図書館情報学の情報探索の研究から考え方を応用しています。
-AIの判断能力は、形式知・ノウハウを収集することで強化されます。
+AIの判断能力は形式知・ノウハウを収集することで強化されます。
原文に書かれた形式知・ノウハウを集めて、AIの判断の材料にすることが、imozuruの元からの役割です。
2.0のメジャーアップデートでは、人間が読むことに重点を置いて強化しました。
調べた分野を読み手の水準に合わせて解説する詳細レポートと、すべての調査を1枚で見返せるダッシュボードを追加しています。
-版ごとの変更は [CHANGELOG.md](CHANGELOG.md) に記載しています。
+バージョンごとの変更は [CHANGELOG.md](CHANGELOG.md) に記載しています。
## 既存のAI調査手法との差別化点
@@ -54,7 +54,7 @@ Claudeはまず、問いと、答えるために必要な論点を3〜6個書き
/plugin install imozuru@imozuru
```
-プラグインには版の番号を付けていないので、main にコミットが入るたびに新しい版として扱われます。
+プラグインにはバージョン番号を付けていないので、main にコミットが入るたびに新しいバージョンとして扱われます。
自動で最新にしたいときは、`/plugin` のマーケットプレイスの画面で imozuru の自動更新を入れてください。
手で更新するときは `claude plugin marketplace update imozuru` を実行します。
@@ -171,7 +171,7 @@ tailscale serve --bg 8765
合言葉は環境変数 `IMOZURU_SERVE_TOKEN` で固定できます(16文字以上)。
固定しないと起動のたびに変わり、ホーム画面に追加したアイコンから開けなくなります。
-配信した画面は、アプリとして入れられます。
+配信した画面はアプリとして入れられます。
スマホでもパソコンのChrome・Edgeでも、右上の入れるボタンを押すと、ブラウザの入れる画面か、そのブラウザでの手順が出ます。
入れたアプリは合言葉を入力せずに開けます。
@@ -179,17 +179,19 @@ tailscale serve --bg 8765
### 要約しない理由
-Kuhlthau(1991)は、調べ始めの混乱した段階で詳しくまとめると、早すぎる閉じ(premature closure)を招き、探索の過程が妨げられると述べています。
+Kuhlthau(1991)は調べ始めの混乱した段階で詳しくまとめると、早すぎる閉じ(premature closure)を招き、探索の過程が妨げられると述べています。
そのためimozuruは、調べている間は原文の場所を示すところまでにとどめています。
解説を書くのは、止める判定が出たあとの詳細レポートだけです。
### 止めどきの決め方
止める条件は2つです。
-1つ目は、すべての論点に原文の場所が付くことで、証拠がそろったかで止めどきを決めるRohとHan(2026)のHALTにならいました。
+1つ目はすべての論点に原文の場所が付くことです。
+この条件は、証拠がそろったかで止めどきを決めるRohとHan(2026)のHALTにならいました。
論点が原文を読まずに答えられる形ばかりにならないよう、少なくとも1つは依頼の言葉の条件をそのまま含め、半分以上は原文を読まないと答えられない形にしています。
-2つ目は飽和で、2本の検索役が挙げた資料の7割以上がすでに地図にあれば止めます。
+2つ目は飽和です。
+2本の検索役が挙げた資料の7割以上がすでに地図にあれば止めます。
独立した2回の探索の重なりから全体の数を見積もる考え方(Kastner 2007)を借りたもので、7割は試行で決めた仮の目安です。
### 方向を1つに決めない理由
diff --git a/assets/screenshots/dashboard.webp b/assets/screenshots/dashboard.webp
index 6a16372..fff4164 100644
Binary files a/assets/screenshots/dashboard.webp and b/assets/screenshots/dashboard.webp differ
diff --git a/skills/imozuru/SKILL.md b/skills/imozuru/SKILL.md
index 53550f4..b56ecd6 100644
--- a/skills/imozuru/SKILL.md
+++ b/skills/imozuru/SKILL.md
@@ -54,13 +54,13 @@ watch/ … 見張りの結果。<日付>.md
### 0. 問いと「調査の論点」を書く
-map.md を下の書式で作り、**問い**と、答えるのに要る**論点**を3〜6個並べる(例: 「この分野で〇〇をどう呼ぶか」「定番の手法は何か」「どこで失敗するか」)。論点は、いつ止めるかを決める基準になる(HALT・Roh & Han 2026)。
+map.md を下の書式で作り、**問い**と、答えるのに要る**論点**を3〜6個並べる(例: 「この分野で〇〇をどう呼ぶか」「定番の手法は何か」「どこで失敗するか」)。論点はいつ止めるかを決める基準になる(HALT・Roh & Han 2026)。
論点は、どれにもすぐ原文が付く形に作れてしまう。試行では5つ全部が「〜がある」で、1周で原文が付いて止まり、依頼の中心の条件(「AI で生成した画像を」)が確かめられないまま残った。だから次を守る。
- **少なくとも1つは、依頼の言葉の条件をそのまま入れる**(例: 依頼が「AI で生成した画像を編集できるデータに」なら「AI 生成画像に当てた結果や事例がある」)
- **「〜がある」だけで埋めない**。半分以上は「どれくらい効果があるか」「どこで失敗するか」「何が足りないか」のように、原文を読まないと答えられない形にする
-- **調査の論点の1つ目は、いつも「この分野の知見はどこに集まっているか(媒体)」にする**。どこを当たるかを、固定の一覧ではなく調べて決めるため(下の「1. map.md を作る」)
+- **調査の論点の1つ目はいつも「この分野の知見はどこに集まっているか(媒体)」にする**。どこを当たるかを、固定の一覧ではなく調べて決めるため(下の「1. map.md を作る」)
- **コツや定番のやり方を聞く問いでも、1つは「そのコツの元になった原典・研究はあるか」にする**。無ければ「探した範囲では無かった」と書く。チュートリアルだけで答えると、元にある研究に届かないまま「規則は無い」と結論しやすい(2026-10-12 の比較で、素の頼み方は3回とも「規則は無い/理論ではない」と結論した。原典を問いに入れずに調べた imozuru も Rood 1879 に届かなかった)
問いは途中で変わってよい。人の調べものは、読むうちに問いが変わり、そのつど別の場所から少しずつ拾っていく形で進む(Bates 1989 の berrypicking)。変わったら map.md の問いと論点を書き直し、log.md に理由を書く。
@@ -69,7 +69,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
検索役を**違う探し方で2本**並べる。既定は英語と日本語。片方で足りる分野なら「用語で検索」と「定番の総説と教科書を探す」に分ける。違う探し方の2本で同じものが出るほど、map.md の用語・人・媒体が出そろってきた印になる(capture-recapture の考え方・Kastner 2007)。
-検索役への頼み方:
+検索役には次のように頼む。
- 返してほしいのは4つ=**用語**(それが出た URL)・**人**(所属・代表作)・**媒体**(学会・雑誌・一覧・リポジトリ)・**定番の資料**(題名・著者・年・無料で読める URL)
- 報告は「見つけた/探したが無い/探していない」の3つに分けてもらう。「探していない」がそのまま次の手がかりになる
- **要約は頼まない**。名前と URL を正確に拾うことを優先させる
@@ -86,7 +86,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
### 2. たどる(各周)
-次の手がかりから、たどる価値の高そうなもの(何度も名前が出る・総説や教科書・定番として引かれる・何人もが「この人の記事を見て」と挙げる)を選んでたどる。たどり方は6つ(Bates 1989・Ellis 1987)。論文の世界でも個人の発信の世界でも同じ動きで、たどる先が違うだけ:
+次の手がかりから、たどる価値の高そうなもの(何度も名前が出る・総説や教科書・定番として引かれる・何人もが「この人の記事を見て」と挙げる)を選んでたどる。たどり方は6つ(Bates 1989・Ellis 1987)。論文の世界でも個人の発信の世界でも同じ動きで、たどる先が違うだけ。
| 動き | 論文なら | 個人の発信なら | 道具 |
|---|---|---|---|
@@ -107,7 +107,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
- **fetch.py には限界がある**。標準ライブラリで1回頼むだけなので、次の3つでは取れない。有料・ログイン・404 でない FAIL は、届かなかったと書く前に、使える道具で取り直すことを勧める
- 名乗りや接続の仕方でサイトが 403 を返す、または本文を JavaScript で描く画面で、生の HTML に本文が無い(本文が1字や数十字の FAIL)。**Playwright など本物のブラウザ**で開き、返った PDF か描画した本文を保存する(試行では学会の PDF の 403 と、大学のリポジトリの JavaScript の画面が取れた)
- 資料が本当に短い(1頁の要約など)。「短すぎる」の FAIL は、先に頁数や描画した本文で本当に短いかを確かめる。短いなら、そのまま保存して原文の表に(短い資料)と書く
- - Cloudflare などの確認画面。headless のブラウザでも通らない。**ユーザーのブラウザを操作できる道具(DevTools をつなぐ MCP など)**があれば、そのブラウザで同じ URL を開いて確認画面が自然に通るのを待ち、転送先の URL を fetch.py に渡す。無ければユーザーに開いてもらう
+ - Cloudflare などの確認画面。headless のブラウザでも通らない。**ユーザーのブラウザを操作できる道具**(DevTools をつなぐ MCP など)があれば、そのブラウザで同じ URL を開いて確認画面が自然に通るのを待ち、転送先の URL を fetch.py に渡す。無ければユーザーに開いてもらう
- どの道具で取ったものも、fetch.py と同じ検査(PDF なら文字起こしの長さ、壁のページでないか)を通してから sources/ に置き、fetch-log.jsonl に取り方を書き添える。手元や内側の宛先へは、ブラウザでも取りに行かない。確認画面をすり抜ける細工はしない
- **FAIL や有料で取れなかった定番は、届かなかったと書く前に別の置き場を探す**。著者や研究室のページ、その分野のまとめサイト、元になった技術報告、大学のリポジトリを当たる。2026-10-14 には、DTIC で 403 だった Mann & Thompson と Hovy の原典が、SFU の RST サイトに置いてあった。海賊版サイトは使わない
- 保存したら、調査の論点に関わるところを .txt / .md で grep して**行番号を確かめる**。map.md の論点の行に「どのファイルの何行目か」を書く。ここで書くのは原文の場所と短い引用で、まとめや結論は書かない
@@ -117,7 +117,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
**起動した検索役が全部戻ってから判断する**。待たずに先へ進めた検索役は、その場で止める。
-**0周目は、検索役を並べて map.md を作るまで**(原文はまだ保存しなくてよい)。**1周=手がかりから原文を保存し、そこから少なくとも1回たどる(後ろへ・前へ・著者で追うのどれか)まで**。検索役を並べ直すかどうかは問わない。論文の無い分野では、保存した記事の中のリンクを後ろへたどれば1回と数える。検索役が空振りして親が自分で探した周も1周に数える(その周は飽和を数えない)。**空振り**=検索役の挙げた中に、保存して調査の論点に関わると分かったページが1つも無いこと(検索結果の件数ではない。検索役はページを開かずに報告するので、調査の論点に関わるかは親が保存して初めて分かる)。
+**0周目は検索役を並べて map.md を作るまで**(原文はまだ保存しなくてよい)。**1周=手がかりから原文を保存し、そこから少なくとも1回たどる(後ろへ・前へ・著者で追うのどれか)まで**。検索役を並べ直すかどうかは問わない。論文の無い分野では、保存した記事の中のリンクを後ろへたどれば1回と数える。検索役が空振りして親が自分で探した周も1周に数える(その周は飽和を数えない)。**空振り**=検索役の挙げた中に、保存して調査の論点に関わると分かったページが1つも無いこと(検索結果の件数ではない。検索役はページを開かずに報告するので、調査の論点に関わるかは親が保存して初めて分かる)。
各周の終わりに、次のどれかなら止める。理由を log.md に書く。
@@ -154,7 +154,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
原文を何十本も保存しただけでは読まれない(英語の PDF や1時間の字幕のまま)。かといって要約すると、早すぎる結論を招く。だから止めたら、**抜き書き**(Ellis の extracting)でページを作り、それを最初に渡す。
1. `<topic_dir>/extracts.json` を書く。調査の論点ごとに節を立て、原文から**そのまま切り出した文**を並べる(ファイル・行・必要なら `end`)。英語には `ja` に訳を添える(訳だと分かる印がページに付く)。印(〔本人〕自動字幕 など)は `mark` に。2段組の PDF のように左右の段が1行に混ざる所は、抜き書きを「…」で区切ると区切りごとに順に照合される(省いたことはページにも「…」で見える)。食い違いは `disagreements` に並べるだけで、どれが正しいかは書かない。届かなかったものは `unreached` に。形の手本はリポジトリの `examples/demo/extracts.json`
- 形(report.py の冒頭と同じ。`?` は省いてよい):
+ 形は report.py の冒頭と同じ(`?` は省いてよい)。
```
{"title", "question", "stopped",
"claims": [{"claim", "status": "根拠あり|一部のみ|根拠なし", "note"?,
@@ -179,10 +179,10 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
- 3編に共通で、人物と媒体(誰がどこで発信しているか)と、未解決の点(原文が付かなかった論点・届かなかった資料)
- **記録**: `queries.jsonl` と `fetch-log.jsonl` から機械で組む。周ごとに、検索語・誰が探したか・ヒットの全件を並べ、それぞれに〔保存〕〔取得失敗〕〔未取得〕を付ける。空振りの検索語も載る。検索で挙がっていない取得(記事の中のリンクをたどったもの)も別に並ぶ。エージェントはこの層を書かない
-手順:
+手順は次のとおり。
1. `<topic_dir>/digest.json` を書く。**解説の1文ごとに、根拠として原文からそのまま切り出した引用を1つ以上付ける**(ファイル・行・必要なら `end`。抜き書きと同じ形)。根拠の無い文は書かない。編をまたいで同じ引用を使ってよい
- 形(digest.py の冒頭と同じ):
+ 形は digest.py の冒頭と同じ。
```
{"title", "question", "stopped",
"claims": [{"claim", "status": "根拠あり|一部のみ|根拠なし"}],
@@ -245,7 +245,7 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
- <まだたどっていないもの> — <なぜたどる価値がありそうか>
```
-「読み:」は、履歴のページの一覧の検索で、漢字の語をひらがなやローマ字でも当てるためのもの(夕焼け を ゆうやけ・yuuyake で)。カタカナと英字の語は書かなくても当たる。読みの辞書は外部のデータしか無く、標準ライブラリだけでは付けられないので、問いを書くときに一緒に書く。
+「読み:」は履歴のページの一覧の検索で、漢字の語をひらがなやローマ字でも当てるためのもの(夕焼け を ゆうやけ・yuuyake で)。カタカナと英字の語は書かなくても当たる。読みの辞書は外部のデータしか無く、標準ライブラリだけでは付けられないので、問いを書くときに一緒に書く。
節の順番は変えない。追記は各節の末尾に足す(周をまたいで表が散らばるのを防ぐ)。原文の表は1論文1行で、PDF と .txt、抄録の .md のように複数のファイルがあれば同じ行に並べる。検索役由来で原文を開いていない行には(未確認)を付ける。
@@ -270,16 +270,16 @@ map.md を下の書式で作り、**問い**と、答えるのに要る**論点*
## 道具
-スクリプトは Python 3.10 以上の標準ライブラリだけで動く。外部コマンドは、あれば使う(無いときの動きは各行に書いた)。
+スクリプトは Python 3.10 以上の標準ライブラリだけで動く。外部コマンドはあれば使う(無いときの動きは各行に書いた)。
-- `scripts/fetch.py <sources_dir> <name> <url>` — ダウンロードして本物か確かめる。PDF は .pdf と .txt(`pdftotext -layout`・poppler か Xpdf)、HTML は .md、YouTube は字幕を `[分:秒] 文` の .md(`yt-dlp`・動画は保存しない)。文字の層が無い PDF は `pdftoppm` と `tesseract` で OCR する。言語は tesseract の言語データに `jpn`・`jpn_vert` があれば英語に足し、環境変数 `IMOZURU_OCR_LANG` があればそれを使う。読み取りの確信度が低いとき(言語データが合わず意味のない字の列になったとき)と、読めなかったページがあるときは OCR の結果を使わず、理由を添えて `FAIL` する。要るコマンドが無いときは、無いコマンドの名前を書いて `FAIL` する。HTML は [ax](https://github.com/yusukebe/ax) があれば ax で、無ければ標準ライブラリで本文を文字にする(見出しや表の形は ax のほうが残る)。取得はいつも fetch.py 自身が宛先を確かめながら行い、ax には取ってきた HTML を渡して変換だけさせる。HTML のページは、名乗りを変えてもう一度頼み、PDF 本体が返ればそちらを残す(HAL はブラウザの名乗りに閲覧用の HTML を返す)。取ってきたものは作業用のフォルダで検査し、通ったものだけを sources_dir へ移す。PMC(pmc.ncbi.nlm.nih.gov)の記事ページは captcha で取れないので、同じ本文を Europe PMC の全文 XML から取り、見出し・段落・図表の説明・文献を1つずつ1行にした .md にする(題名と書誌は頭の数行。Europe PMC に全文が無ければ `FAIL`)。404・ログインの要求・ボット確認のページ・短すぎる本文は `FAIL`(同じ名前の原文がすでにあれば、そのまま残る)。短さの下限は PDF が 3,000字、HTML が 1,000字で、和文の字が3割を超える PDF は HTML と同じ 1,000字で判定する。X は本文が取れないので取りに行かず `FAIL`=URL と、検索役が拾った抜粋を(未確認)で map.md に残す
+- `scripts/fetch.py <sources_dir> <name> <url>`: ダウンロードして本物か確かめる。PDF は .pdf と .txt(`pdftotext -layout`・poppler か Xpdf)、HTML は .md、YouTube は字幕を `[分:秒] 文` の .md(`yt-dlp`・動画は保存しない)。文字の層が無い PDF は `pdftoppm` と `tesseract` で OCR する。言語は tesseract の言語データに `jpn`・`jpn_vert` があれば英語に足し、環境変数 `IMOZURU_OCR_LANG` があればそれを使う。読み取りの確信度が低いとき(言語データが合わず意味のない字の列になったとき)と、読めなかったページがあるときは OCR の結果を使わず、理由を添えて `FAIL` する。要るコマンドが無いときは、無いコマンドの名前を書いて `FAIL` する。HTML は [ax](https://github.com/yusukebe/ax) があれば ax で、無ければ標準ライブラリで本文を文字にする(見出しや表の形は ax のほうが残る)。取得はいつも fetch.py 自身が宛先を確かめながら行い、ax には取ってきた HTML を渡して変換だけさせる。HTML のページは、名乗りを変えてもう一度頼み、PDF 本体が返ればそちらを残す(HAL はブラウザの名乗りに閲覧用の HTML を返す)。取ってきたものは作業用のフォルダで検査し、通ったものだけを sources_dir へ移す。PMC(pmc.ncbi.nlm.nih.gov)の記事ページは captcha で取れないので、同じ本文を Europe PMC の全文 XML から取り、見出し・段落・図表の説明・文献を1つずつ1行にした .md にする(題名と書誌は頭の数行。Europe PMC に全文が無ければ `FAIL`)。404・ログインの要求・ボット確認のページ・短すぎる本文は `FAIL`(同じ名前の原文がすでにあれば、そのまま残る)。短さの下限は PDF が 3,000字、HTML が 1,000字で、和文の字が3割を超える PDF は HTML と同じ 1,000字で判定する。X は本文が取れないので取りに行かず `FAIL`=URL と、検索役が拾った抜粋を(未確認)で map.md に残す
- 動画の場所は行番号の代わりに時刻で指す(`sources/x.md [12:34]`)
-- `scripts/report.py <topic_dir> [--check]` — extracts.json の抜き書きを原文と照合し、合えば report.html にする。`--check` は照合だけ
-- `scripts/digest.py add <topic_dir> [--round N] [--by 誰]` — 標準入力の JSON(検索語ごとのヒット)を queries.jsonl に足す。`scripts/digest.py <topic_dir> [--check]` — digest.json の解説の引用を原文と照合し、合えば検索の記録と合わせて digest.html にする
-- `scripts/dashboard.py [research_dir] [--runs runs.md]` — 調査の置き場(既定 `~/research`)を走査して、調べものの履歴のページ `index.html` を作る。ホームに区切った理由・原文を取得した媒体・たどった周の数の集計、左の一覧から各調査の詳細(論点・周・原文・文書へのリンク)。数字はフォルダの記録から数え、記録の無い所は「記録なし」と出す
-- `scripts/dashboard.py [research_dir] --bundle <dir>` — 履歴のページと各調査の文書(詳細レポート・抜書き・map.md・log.md)だけを `<dir>` に写す。原文(sources/)は写さない。入れたファイルの一覧を出す。束には原文からの引用が入るので、公開の場所へは置かない。スマホで見る載せ方は検討中(下書き)
-- `scripts/watch.py add|list|check` — 見張り。RSS / Atom を引いて前回からの新着を出す。検索を使わないので費用はかからず結果も揺れない。DOCTYPE・ENTITY を含むフィードは安全のため読まない。フィードの場所にタブや改行が入っていたら足さない
-- `scripts/chain.py find|refs|cites|author [--log <topic_dir> --round N]` — OpenAlex で引用と著者をたどる。`--log` を付けると出した一覧を queries.jsonl に足す。1日 1,000 回まで無料の枠で、プリペイド残高が 0 なら超えても止まるだけ。**API キーや支払いの登録はしない**。古めの論文に強く、新しい論文と同名の多い著者に弱い(author は名前の検索の1位を使うので、同名の別人の論文を返すことがある。出力の「# 別の候補」に別人の ID が並ぶので、所属と論文数で確かめ、違えば `chain.py author A…` で引き直す。ただし OpenAlex の著者の記録は、古い論文ほど当てにならない。著者の欄に ID が無い論文や、同名の何人もの論文を1人にまとめた記録がある(試行では、情報探索の Ellis の 1989 年の論文には ID が無く、1993 年の論文は所属が国際ポテトセンターで論文289本の記録に入っていた)。著者で追うときは、所属先や本人のページにある論文の一覧を検索役に探させ、chain.py author の結果はその一覧と突き合わせる)
+- `scripts/report.py <topic_dir> [--check]`: extracts.json の抜き書きを原文と照合し、合えば report.html にする。`--check` は照合だけ
+- `scripts/digest.py add <topic_dir> [--round N] [--by 誰]`: 標準入力の JSON(検索語ごとのヒット)を queries.jsonl に足す。`scripts/digest.py <topic_dir> [--check]` は、digest.json の解説の引用を原文と照合し、合えば検索の記録と合わせて digest.html にする
+- `scripts/dashboard.py [research_dir] [--runs runs.md]`: 調査の置き場(既定 `~/research`)を走査して、調べものの履歴のページ `index.html` を作る。ホームに区切った理由・原文を取得した媒体・たどった周の数の集計、左の一覧から各調査の詳細(論点・周・原文・文書へのリンク)。数字はフォルダの記録から数え、記録の無い所は「記録なし」と出す
+- `scripts/dashboard.py [research_dir] --bundle <dir>`: 履歴のページと各調査の文書(詳細レポート・抜き書き・map.md・log.md)だけを `<dir>` に写す。原文(sources/)は写さない。入れたファイルの一覧を出す。束には原文からの引用が入るので、公開の場所へは置かない。スマホで見る載せ方は検討中(下書き)
+- `scripts/watch.py add|list|check`: 見張り。RSS / Atom を引いて前回からの新着を出す。検索を使わないので費用はかからず結果も揺れない。DOCTYPE・ENTITY を含むフィードは安全のため読まない。フィードの場所にタブや改行が入っていたら足さない
+- `scripts/chain.py find|refs|cites|author [--log <topic_dir> --round N]`: OpenAlex で引用と著者をたどる。`--log` を付けると出した一覧を queries.jsonl に足す。1日 1,000 回まで無料の枠で、プリペイド残高が 0 なら超えても止まるだけ。**API キーや支払いの登録はしない**。古めの論文に強く、新しい論文と同名の多い著者に弱い(author は名前の検索の1位を使うので、同名の別人の論文を返すことがある。出力の「# 別の候補」に別人の ID が並ぶので、所属と論文数で確かめ、違えば `chain.py author A…` で引き直す。ただし OpenAlex の著者の記録は、古い論文ほど当てにならない。著者の欄に ID が無い論文や、同名の何人もの論文を1人にまとめた記録がある(試行では、情報探索の Ellis の 1989 年の論文には ID が無く、1993 年の論文は所属が国際ポテトセンターで論文289本の記録に入っていた)。著者で追うときは、所属先や本人のページにある論文の一覧を検索役に探させ、chain.py author の結果はその一覧と突き合わせる)
- ファイル名は `<著者>-<年>-<短い題>`、arXiv は `arxiv-<番号>-<短い題>`
## 境界
diff --git a/skills/imozuru/assets/guide-pc-topic.webp b/skills/imozuru/assets/guide-pc-topic.webp
index 94963ee..f3423fa 100644
Binary files a/skills/imozuru/assets/guide-pc-topic.webp and b/skills/imozuru/assets/guide-pc-topic.webp differ
diff --git a/skills/imozuru/assets/guide-sp-topic.webp b/skills/imozuru/assets/guide-sp-topic.webp
index 8b562cf..f4750d5 100644
Binary files a/skills/imozuru/assets/guide-sp-topic.webp and b/skills/imozuru/assets/guide-sp-topic.webp differ
diff --git a/skills/imozuru/references/theory.md b/skills/imozuru/references/theory.md
index c1c9d37..94d6bb2 100644
--- a/skills/imozuru/references/theory.md
+++ b/skills/imozuru/references/theory.md
@@ -1,7 +1,7 @@
# imozuru の拠りどころ
-SKILL.md の各決まりが、どの原文のどこから来たか。原文は 2026-10-09 の試行(題材=探し方の研究)で
-このスキル自身を使って落とした。行番号は、下の URL を `scripts/fetch.py` で落とした .txt / .md のもの
+SKILL.md の各決まりがどの原文のどこから来たかを、ここにまとめる。原文は 2026-10-09 の試行(題材=探し方の研究)で
+このスキル自身を使って取得した。行番号は下の URL を `scripts/fetch.py` で取得した .txt / .md のもの
(PDF は `pdftotext -layout`、HTML は ax で変換。変換の仕方が違うと行番号はずれるので、短い引用で探す)。
決まりを直すときは、ここで元の文を読み直してから直す。
@@ -52,8 +52,8 @@ SKILL.md の各決まりが、どの原文のどこから来たか。原文は 2
- 題材=探し方の研究(親が手で)/AI 生成画像の編集可能化(論文の多い分野・2回)/大陸塗り(論文が無く個人の発信だけの分野)
- 論点を「〜がある」だけで並べると1周で埋まり、依頼の芯が抜けたまま止まる → 論点の1つは依頼の条件そのまま、半分以上は原文を読まないと答えられない形
-- 論文の多い分野では chain.py が古い論文に効き、新しい論文(出て1年ほど)には効かない
+- 論文の多い分野では、chain.py で古い論文の引用はたどれるが、新しい論文(出て1年ほど)の引用はたどれない
- 個人の発信の分野では chain.py も DOI も使えず、道具は fetch.py と WebSearch だけ。standard の検索はほぼ空振りで extended で一斉に出た。大事な中身は X・pixiv・小紅書のログインの壁の向こうに集まる
-- 日本語の記事は短くても本物(2,904字)。英語の論文向けの下限 3,000 字では落ちる
+- 日本語の記事は短くても本物(2,904字)。英語の論文向けの下限 3,000 字では FAIL になる
- PDF でも同じ。和文の字が3割を超える PDF は HTML と同じ 1,000 字で判定する
- 検索役の報告は検索結果の抜粋がもと。Type-R の説明が原文と違っていた
diff --git a/skills/imozuru/scripts/dashboard.py b/skills/imozuru/scripts/dashboard.py
index 901c597..5c2d213 100644
--- a/skills/imozuru/scripts/dashboard.py
+++ b/skills/imozuru/scripts/dashboard.py
@@ -12,7 +12,7 @@
research_dir … 調査の置き場(既定 ~/research)。直下のフォルダを1件の調査として読む
--runs … 回した記録の台帳(任意)。「調査を区切った理由」「感覚と合った?」の列を読む
--out … 書き出す先(既定 <research_dir>/index.html)
- --bundle DIR … ページと各調査の文書(詳細レポート・抜書き・map.md・log.md)だけを DIR に写す。
+ --bundle DIR … ページと各調査の文書(詳細レポート・抜き書き・map.md・log.md)だけを DIR に写す。
原文(sources/)は写さない。スマホで見るためにどこかへ載せる束で、入れたファイルの一覧を出す
--serve [PORT] … ページと文書を 127.0.0.1:PORT(既定 8765)で配る。読み取り専用で、合言葉つきの URL を出す。
合言葉は IMOZURU_SERVE_TOKEN で固定できる(スマホのブックマークを保つため)
@@ -244,7 +244,7 @@ def topic_info(d: Path, runs: list[dict]) -> dict:
fetches = load_jsonl(d / "fetch-log.jsonl")
info["fetch_ok"] = sum(1 for f in fetches if f.get("status") == "OK") if fetches else None
info["fetch_ng"] = sum(1 for f in fetches if f.get("status") == "FAIL") if fetches else None
- info["docs"] = [(name, label) for name, label in (("digest.html", "詳細レポート"), ("report.html", "抜書き"),
+ info["docs"] = [(name, label) for name, label in (("digest.html", "詳細レポート"), ("report.html", "抜き書き"),
("map.md", "map.md"), ("log.md", "log.md"))
if topic_file(d / name)]
return info
@@ -285,7 +285,7 @@ def write_bundle(topics: list[dict], root: Path, dest: Path) -> int:
for f in files:
print(f)
print(f"→ {dest}({len(files)} ファイル・{size / 1e6:.1f} MB。原文は入れていない)")
- print("注意: 詳細レポートと抜書きには原文からの引用が入る。束を人に渡すときや公開の場所へ置くときは中身を確かめる")
+ print("注意: 詳細レポートと抜き書きには原文からの引用が入る。束を人に渡すときや公開の場所へ置くときは中身を確かめる")
return 0
@@ -1773,7 +1773,7 @@ def guide_html(topics: list[dict]) -> str:
"<li>配信した画面(<code>--serve</code>)を Chrome か Edge で開くと、右上の入れるボタンでアプリとして入れられます。タスクバーやスタートメニューから、ブラウザを開かずに起動できます</li>")
# 両方の端末に共通の操作(2026-10-25 かしぇ「pdf出力」「フィードバック、レビュー送るモーダル」)
ops_both = ("<li>文書の表示中は、左下の2つ目のボタンで、その文書を PDF で保存(印刷)できます。根拠の引用は開いた状態で印刷されます</li>"
- + ("<li>右上の吹き出しのボタンから、作者へ感想・要望を送れます。送るのは書いた内容と版・ブラウザの種類だけです</li>" if feedback_form() else ""))
+ + ("<li>右上の吹き出しのボタンから、作者へ感想・要望を送れます。送るのは書いた内容とバージョン・ブラウザの種類だけです</li>" if feedback_form() else ""))
ops_sp += ops_both
ops_pc += ops_both
phone = ("<ol><li>PC で <code>dashboard.py --serve</code> を実行します。合言葉付きの URL が表示されます</li>"
@@ -1783,7 +1783,7 @@ def guide_html(topics: list[dict]) -> str:
"<p>配信用の窓口は PC 内部(127.0.0.1)でのみ待ち受け、Tailscale が自分の機器にだけ中継します。"
"合言葉は <code>IMOZURU_SERVE_TOKEN</code> で固定できます。固定しないと起動ごとに変化し、ホーム画面のアイコンから開けなくなります。</p>")
claims = '<ul class="claims">' + "".join(f"<li>{status_chip(st)}<span>{esc(text)}</span></li>" for st, text in (
- ("根拠あり", "論点に原文の所在が付いています。"), ("一部のみ", "論点の一部にのみ原文が付いています。"),
+ ("根拠あり", "論点に原文の場所が付いています。"), ("一部のみ", "論点の一部にのみ原文が付いています。"),
("根拠なし", "探索したものの、原文が付いていません。"), ("未確認", "抜き書きが未作成のトピックで、地図の論点にまだ印がありません。"))) + "</ul>"
counts = (f"<ul><li>トピック: 調査の保存先(既定 <code>~/research</code>)直下のフォルダ1つを1件と数えます</li>"
f"<li>原文: <code>sources/</code> のファイルを、拡張子を除いた名前で集計します(PDF とその文字起こしは1本)</li>"
@@ -1794,7 +1794,7 @@ def guide_html(topics: list[dict]) -> str:
"<li>台帳記載の周回数・原文数が集計値と異なる場合のみ、括弧で台帳の値を併記します</li>"
"<li>「記録なし」は、0 と区別するための表示です</li></ul>")
return sentence_lines(f"""<h2><span lang="en">imozuru</span> 調査記録とは</h2>
-<p class="lead">imozuru で行った調査を、トピックごとに並べたダッシュボードです。トピックは、1つの疑問について調べたひとまとまりのことを指します。過去のトピックとその文書を探し出し、それぞれがどこまで進んでどう終わったかを見比べられます。</p>
+<p class="lead">imozuru で行った調査を、トピックごとに並べたダッシュボードです。トピックは1つの疑問について調べたひとまとまりのことを指します。過去のトピックとその文書を探し出し、それぞれがどこまで進んでどう終わったかを見比べられます。</p>
<div class="card"><h3>スキルのフロー</h3>
<p>imozuru は1つのトピックを、次の段の順に進めます。各段の下の名前は、その結果が出る画面の項目です。</p>
<ol class="flow" start="0">{flow}</ol></div>
@@ -1859,7 +1859,7 @@ FIND_HTML = ('<label class="find"><svg class="lens" viewBox="0 0 24 24" width="1
# 0件のとき。無かったことと打った語をはっきり出し、次の一手(語を消す)を添える。どこを探したかも書く
# (NN/g 2014「Clearly explain that there are no matching results」・ビービット 2007「次にどういうアクションを取ればよいか」)
FIND_NONE = ('<div class="find-none" hidden><p>「<b class="nq"></b>」に当てはまるトピックはない</p>'
- '<p class="where">題名・読み・用語・人・媒体から探した</p><button type="button">検索語を消す</button></div>')
+ '<p class="where">題名・疑問・読み・用語・人・媒体から探した</p><button type="button">検索語を消す</button></div>')
def pager_html(kind: str) -> str:
@@ -1885,7 +1885,7 @@ def install_html() -> str:
}
plats = "".join(f'<div data-plat="{k}">{v}</div>' for k, v in steps.items())
return (f'<section class="inst-bar" id="inst-bar" aria-labelledby="inst-h" hidden><span class="ic">{INSTALL_ICON}</span>'
- '<div class="tx"><h2 id="inst-h">アプリとして入れる</h2><p>アイコンから、ブラウザを開かずに開けます</p></div>'
+ '<div class="tx"><h2 id="inst-h">アプリとして入れる</h2><p>アイコンから、ブラウザを開かずに起動できます</p></div>'
f'<button class="btn pri go" type="button">入れる</button><button class="x" type="button" aria-label="この案内を閉じる">{CLOSE_ICON}</button></section>'
'<dialog class="dlg" id="inst-dlg" aria-labelledby="inst-dh"><div class="in"><h2 id="inst-dh">アプリとして入れる</h2>'
'<p class="lead">入れると、ホーム画面やタスクバーのアイコンから、この調査記録をすぐに開けます。合言葉の入力は要りません。</p>'
@@ -1908,7 +1908,7 @@ def feedback_html(form: dict) -> str:
f'<form method="post" action="{esc(form["action"])}" target="_blank" rel="noopener noreferrer">'
f'<fieldset><legend>種類</legend><div class="chips">{kinds}</div></fieldset>{rating}'
'<label class="lbl" for="fb-body">内容</label><textarea id="fb-body" name="' + form["body"] + '" required maxlength="4000"></textarea>'
- f'{hidden}<p class="what">送るのは、ここに書いた内容と、imozuru の版({esc(version)})・ブラウザの種類だけです。調査の題や中身は送りません。'
+ f'{hidden}<p class="what">送るのは、ここに書いた内容と、imozuru のバージョン({esc(version)})・ブラウザの種類だけです。調査の題や中身は送りません。'
'送ると、Google フォームの受付画面が別のタブで開きます。</p>'
'<div class="acts"><button class="btn" type="button" data-close>取消</button><button class="btn pri" type="submit">送る</button></div></form>'
'<div class="done" role="status"><p>受付の画面を別のタブで開きました。そこに「回答を記録しました」と出ていれば届いています。ありがとうございます。</p>'
diff --git a/skills/imozuru/scripts/palette.py b/skills/imozuru/scripts/palette.py
index e034009..86fb6ed 100644
--- a/skills/imozuru/scripts/palette.py
+++ b/skills/imozuru/scripts/palette.py
@@ -1,11 +1,11 @@
-"""imozuru が書き出すページ(履歴ダッシュボード・抜書き・詳細レポート・戻るボタン)の色の唯一の置き場。
+"""imozuru が書き出すページ(履歴ダッシュボード・抜き書き・詳細レポート・戻るボタン)の色の唯一の置き場。
色はすべて OKLCH で、ここの色見本(SWATCH)から役割の名前へ割り当てる。ページの側は役割の名前
(CSS の変数)だけを使い、色の値を直接書かない。透かしは color-mix で役割の色から作る。
tests/test_palette.py が、書き出したページの中の oklch() がすべてここの値かを確認する。
外観は「昆虫の標本箱」(2026-10-21 かしぇが3つの棚の見本から A を選んだ)。胡桃材の濃い地に象牙の面、
-標本の色を点で入れる。文書(抜書き・詳細レポート)は象牙の紙を地にし、暗い設定では胡桃材の地にする。
+標本の色を点で入れる。文書(抜き書き・詳細レポート)は象牙の紙を地にし、暗い設定では胡桃材の地にする。
"""
SWATCH = {
@@ -53,7 +53,7 @@ DASH = {
"umbra": "umbra", "glass": "glass", "cork": "cork", "brass": "brass", "brass-dark": "brass-dark", "beni": "beni",
}
-# 抜書きと詳細レポート。明るい設定は象牙の紙、暗い設定は胡桃材
+# 抜き書きと詳細レポート。明るい設定は象牙の紙、暗い設定は胡桃材
DOC_LIGHT = {"bg": "ivory-2", "ink": "sumi-1", "sub": "sumi-3", "accent": "amber-dark",
"card": "ivory-1", "line": "ivory-5", "hit": "ivory-4"}
DOC_DARK = {"bg": "walnut-2", "ink": "ivory-3", "sub": "ivory-6", "accent": "amber-light",