Wiki スキル
このスキルは、エージェントを <VAULT_ROOT>(リポジトリルート)にあるユーザーの個人ナレッジベースの規律ある管理者に変えます。
ステップ 0 — 最初に AGENTS.md を必ず読んでください
何かをする前に、ボールトルートにある AGENTS.md を読んでください。そこにはディレクトリ構成、ページ規約、フロントマタースキーマ、ログ形式、詳細なワークフローが定義されています。この SKILL.md は単なるディスパッチャーであり、AGENTS.md が真実の情報源です。
ディスパッチ:ユーザーは何を求めていますか?
ユーザーのメッセージから、以下の意図を正確に1つ選択してください:
| ユーザーの意図 | ワークフロー |
|---|---|
| 質問をしている、分析・統合を求めている | クエリ(以下参照) |
| 新しいファイルをドロップした、または「これを取り込んで」と言った | 取り込み(AGENTS.md §4.1 参照) |
| 「lint」/「ヘルスチェック」/「問題を探して」と言った | Lint(以下参照) |
| 比較・スライドデッキ・グラフ・レポートを求めている | アーティファクト生成(以下参照) |
| 探索中、または不明確 | wiki stats を実行してからユーザーに何をしたいか尋ねる |
不明な場合は、先に進む前に短い確認の質問を1つしてください。
クエリワークフロー
-
リポジトリルートで
wiki search <キーワード>を実行して候補ページを見つけます。必要に応じて複数のキーワードバリエーションを使用します。 -
wiki/index.mdを読んでカタログを確認します。 -
ステップ1で見つけた候補ページを読みます。
-
それでもコンテキストが不足している場合は、
raw/またはclippings/にある関連ファイルを読みます。 -
wiki ページへの
[[wikilink]]引用と、元ソースへの[文章](../raw/xxx.md)引用を使用して回答を統合します。 -
回答に永続的な価値がある場合(比較、派生した洞察、重要な統合など)、フロントマター付きのマークダウンファイルとして
output/<YYYY-MM-DD>-<短いスラッグ>.mdに書き込みます:--- type: artifact kind: answer | comparison | analysis | report | slides created: <日付> question: "<ユーザーの質問をそのまま>" sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...] ---その後、ユーザーに「要不要把这份输出归档为
wiki/questions/<slug>.md?」と尋ねます。(承諾された場合、コピーして index.md と log.md を更新します。) -
回答が自明な場合(事実を調べただけなど)、チャットで回答するだけでファイルは不要です。
Lint ワークフロー
wiki lintを実行します — これによりlint/<今日の日付>.mdが自動的に作成されます。- そのファイルを読み、ユーザーに要約します(どの問題が本物で、ドキュメント内のリテラルな
[[examples]]のような誤検出はどれか)。 - 優先順位付けされた修正計画を提案します。自動修正は行わず、ユーザーに選択させてください。
アーティファクト生成ワークフロー
クエリと同様ですが、成果物の形式が明示的(テーブル / Marp スライド / Python グラフ / キャンバス)です。常に output/ に保存します。スライドデッキには Marp マークダウン形式を使用します。グラフの場合は Python スクリプトを output/scripts/ に書き、実行して画像も生成します。
出力ディレクトリの規約
output/
├── 2026-06-26-rag-vs-llm-wiki.md # 回答 / 比較アーティファクト
├── 2026-06-26-karpathy-summary.slides.md # Marp スライドデッキ
├── scripts/ # グラフ生成用のヘルパースクリプト
└── assets/ # レンダリング画像、エクスポート
output/ ディレクトリは LLM 所有、追記専用です(許可なく以前のアーティファクトを削除しないでください)。各ファイルには上記のフロントマターが必要で、ユーザーが後でアーティファクトを wiki に昇格できるようにします。
利用可能な CLI コマンド(<VAULT_ROOT> から実行)
意図的に最小限の4つのコマンドのみ:
wiki stats # 概要:タイプ/ステータス別のページ数
wiki log -n 10 # wiki/log.md の最後の N エントリ
wiki search <regex> # 全文検索(--scope wiki|raw|clippings|all)
wiki lint # lint/<今日の日付>.md に孤立/壊れたリンク/スタブを書き出す
その他の操作(ページ作成、フロントマター編集、index.md 更新、log.md への追記)は、マークダウンファイルを直接読み書きして行います。ファイル編集に CLI を要求しないでください — それはあなたの仕事です。
重要なルール(AGENTS.md より)
raw/またはclippings/内のファイルは決して変更しないでください。- すべての取り込みで
wiki/index.mdを更新し、wiki/log.mdの先頭に## [YYYY-MM-DD] ingest | <タイトル>形式のエントリを追加します。 - wiki ページ間では
[[二重ブラケット]]で相互参照します。 - ページには YAML フロントマター(
type、tags、created、updated、sources、status)が必要です。 - 不明な場合はユーザーに尋ねてください。黙って大規模なリファクタリングを行わないでください。
報告スタイル
ワークフロー完了後、ユーザーに短い概要を報告します:
- 実行した内容(1〜3箇条書き)
- 作成または変更されたアーティファクト(相対パス)
- 未解決の質問や新たに気づいたギャップ
簡潔にまとめてください。ユーザーは並行して Obsidian を閲覧しており、ファイルの変更を確認できます。