ai-wiki — ナレッジベースへのファイル投入(軽量版・デフォルト)
「これをノートにして」という指示を、正しい名前・正しいリンクを持つノートとしてAI管理フォルダ内に作成します。
このコマンドはトピックを作成しません。 1つのノートを生成し、既存のノートへの[[wikilink]]が少なくとも1つ必要です。ノートをトピックハブ下に配置し、相互リンクを張るには、/ai-wiki-fullを使用してください。
なぜトピックがデフォルトでオフなのか:すべての論文に専用ハブを作ると、ハブは何も整理しません——単に論文の名前が長くなるだけです。トピックとは研究の方向性であり、論文の主題ではありません。判断基準は
references/note-specs.mdの「トピックと見なせるもの」にあります。
出力先
このスキルがファイルするものはすべてAI管理フォルダ内に配置されます。
| ゾーン | 扱い方 |
|---|---|
AI管理フォルダ(<AI_WIKI>/**) | 作成・編集・移動・リネーム・削除 — 自由に操作可 |
| ユーザーの手書きノートフォルダ | 読み取りと検索は自由、追記編集は可。削除・リネーム・移動・上書きの前に確認 |
.claude/rules/、CLAUDE.md | 静的設定 — ユーザーがClaudeの動作変更を依頼した場合のみ編集。updated:を更新。唯一の動的例外は .claude/rules/active.md |
.obsidian/、.trash/ | アクセスは可能だが操作禁止 — Obsidianの設定を編集するとvaultが破損する可能性あり |
権限レベルでブロックしているものはないため、上記の制約は判断に委ねられます。vaultは通常gitリポジトリではありません。手書きノートを誤って上書きした場合、ファイル同期のバージョン履歴からのみ復元可能です。
これらのゾーンから読み取り、要約をAI管理フォルダにファイルすることが、このスキルの目的です。
参照ファイル — 必要に応じて1つだけ読む(4つすべては不要)
| ファイル | 読むタイミング |
|---|---|
references/vault-guide.md | どのフォルダに振り分けるかを決める — ルーティングテーブル、ユーザーの典型的な言い回し例、タグ/ウィキリンクモデル |
references/note-specs.md | 論文ノート、学習ノート、トピック計画を作成する — ファイル名、フロントマター、セクション仕様、表現ルール |
references/figures-diagrams.md | ノートに図が必要な場合 — 抽出コマンド、埋め込み形式、Mermaid記法のルール |
references/tools.md | 入力に対してどのスキルまたはCLIを使うか、およびエンドツーエンドのワークフロー |
通常のファイリング(フォルダが一意に決まり、図も不要)にはこれらの参照ファイルは不要です — 以下に示す手順で十分です。
手順
- 分類 —
references/vault-guide.mdのルーティングテーブルから、宛先フォルダを1つだけ選択します。1つのコンテンツに対して1つのフォルダ。横断的な内容はtags:と[[wikilinks]]で表現し、重複コピーは禁止。- 未確定、探索的、またはバッチ処理のヒットは、実際のフォルダではなく
Inbox/へ。 - 2つのフォルダ間で真に曖昧な場合は、質問する — 推測して重複させてはいけません。
- 未確定、探索的、またはバッチ処理のヒットは、実際のフォルダではなく
- 命名 —
references/note-specs.mdに従い(小文字ケバブケース):- 論文 →
Research/papers/<筆頭著者姓>-<年>-<2-3キーワードスラグ>.md(このコマンドはトピックを作成しないため、ノートはpapers/の直下に置かれます。/ai-wiki-fullはpapers/<topic-slug>/内に配置します) - 学習 →
Research/learning/<トピックスラグ>-<YYYYMMDD>.md
- 論文 →
- 既存ノートの確認 — 書き込む前に
Globで対象フォルダを検索(論文の場合はResearch/papers/**/*.md;トピックごとのサブフォルダに注意)。既存ノートを更新することが、重複を作るよりも優れています。もし既存ノートがあれば、そこにマージし、その旨を伝えます。 - 記入 —
Templates/内の該当するテンプレート(paper-note.md/learning-note.md)をReadし、そのままの位置に記入します。メモリから構造を再構築してはいけません。セクションのガイダンスはreferences/note-specs.mdにあり、テンプレートの{{...}}プロンプトではありません。> [!callout]ブロックは強調システムです — これを維持し、新しいタイプを追加しないでください。- 上部のクイックカードは最後に書きます。完成したノートを圧縮したものです。6行が埋められない場合、下のノートは完成していません。
- S0「この論文が何をするか、平易な言葉で」は必須です:分野の基本は知っているがこの論文は読んでいない人に向けて3〜5文。順序:直面していた状況 → 構築したもの → なぜ機能するか → 得られた結果。このセクションが書けないなら、論文を理解していません — 続行せずに停止して再読してください。
- 論文ノートは以下の順に答えます:S0 平易な言葉 → S1 背景 → S2 先行研究ができなかったこと → S3-S4 手法と数学 → S5 実行した実験 → S6 結果 → S7 限界と著者の将来研究 → S8 自分の分析と研究機会。
- S2とS8がこのノートの存在理由です — どちらも一般的な文章で埋めてはいけません。S4の数学は、ノートから再構成可能でなければならず、単に認識可能であるだけでは不十分です。
- 各S8の機会には4行すべてが必要です(機会 → なぜ未解決か → 最初の実験 → どのトピックにファイルされるか)。「取るに足らない機会 — <理由>」は有効です。捏造は無効です。
- 専門的な表現:比喩的なラベルは禁止(「この論文の切り口」「評決」「最強の数字」)。表現テーブルは
references/note-specs.mdを参照。すべての判断は具体的な証拠に基づかなければなりません。 - 書く前に論文を読んでください。アブストラクトからセクションを埋めてはいけません。セクションのPDFテキストが入手できない場合は、もっともらしい埋め草ではなく
{{not available in source}}と記述します。
- 図 —
references/figures-diagrams.mdに従い:論文の図はpaper-figuresスキルを使って_attachments/paper-figures/<paper-slug>/に抽出(添付ファイルツリーはフラットに保ち、トピックフォルダにミラーリングしない)、各図が機能を発揮するセクションにインライン埋め込み。- 埋め込みプレフィックスはノートの深さに依存します:
papers/直下では../../_attachments/...、papers/<topic-slug>/内では../../../_attachments/...。ノートが移動したときに静かに失敗する唯一の項目です — 1つの画像をスポットチェックしてください。 - 作成者による図は mermaid フェンスを使用します。ASCII アートは禁止です。
- 埋め込みプレフィックスはノートの深さに依存します:
- リンク(必須、最低1つ) — ノートには既存のノートへの
[[wikilink]]が少なくとも1つ必要です:Research/topics/内のハブ、別の論文ノート、または学習ノート。- 最初に
GlobでResearch/topics/とResearch/papers/を検索し、最も近い対象を選び、関係性を1文で述べます(リンクを裸で置かない)。 - このコマンドはトピックを作成しません。 リンク先が本当に何もない場合は、
.claude/rules/active.mdにこの分野が新しいことをフラグし、ユーザーに/ai-wiki-fullがハブを構築するコマンドであることを伝えます。 - ノートが既存のトピックに適合する場合、そのトピックのS6リストに前方リンクを追加します — 相互リンクこそがグラフをクラスタにするものです。
- 最初に
- 登録 — これが新しい方向性を開く場合、または進行中の作業である場合は、
.claude/rules/active.mdに1行のポインタを追加し、updated:を更新します。状態をそこにミラーリングしないでください。active.mdは、明示的な設定変更リクエストなしにこのワークフローが触れる唯一のルールファイルです。
完了前の自己チェック
- 書き込まれたすべてのパスがAI管理フォルダ内にある
- ファイル名がノートタイプの仕様に一致しており、論文ノートは
papers/直下にある(このコマンドはトピックを作成しない) - 埋め込みプレフィックスがノートの深さと一致し、少なくとも1つの画像をスポットチェックした
- フロントマターが完全(
tags:が存在し、具体的であり、単なるresearch/ではない) - 既存のノートへの
[[wikilink]]が少なくとも1つあり、関係性が述べられている - 実際のテンプレートファイルから構築され、セクション順序とコールアウトがそのまま保持されている
- S0の平易な要約が記入済みで、専門用語の羅列ではない
- クイックカードは最後に書かれている。6行すべてが具体的な記述であり、単独で成立する
- 納品されたノートに
{{placeholder}}が残っていない - 比喩的なラベルがない
- 図はインライン埋め込みされており、最後にまとめて置かれていない
- 論文ノート: S2は実際の先行手法名とその具体的な失敗を記述。S7は著者記載/自分の意見/著者の将来研究を分離。S8の結論は証拠を引用し、各機会に4行すべてがある
- 学習ノート: S1はユーザーの質問をそのまま記載。S5には実際の数値例がある
- ユーザーに書き込んだ正確なパスを伝えた
関連
相互リンク付きのトピックハブを作成または検索するには、/ai-wiki-full を使用してください。
入力タイプに応じたツール選択:references/tools.md。ゾーンルールの詳細:.claude/rules/permissions.md。