pin-llm-wiki

/pin-llm-wiki

Karpathy の LLM wiki パターンを自動化します。inbox.md に URL を追加すると、スキルが取得して取り込み、引用付きでエージェントが読み取れるナレッジベースを維持します。

トリガーフレーズ

• /pin-llm-wiki（サブコマンド：init、ingest、lint、queue、remove）
• 「この YouTube 動画を自分の LLM wiki にピン留めして」
• 「これらの調査リンクを自分の wiki に取り込んで」
• 「このナレッジベースで pin-llm-wiki lint を実行して」
• 「これらの URL をキューに追加してから、受信箱をまとめて処理して」
• 「pin-llm-wiki で新しい Karpathy スタイルの wiki を初期化して」

inbox.md (human drops URLs)
    ↓  fetch
raw/  (immutable source captures)
    ↓  ingest
wiki/  (LLM-maintained, cited, linked)
    ↓  lint
a healthy, queryable knowledge base

フェーズ 1 のサブコマンド

コマンド	ステータス
init	実装済み
ingest [<url>]	実装済み（単一 URL 形式では、URL がすでに inbox にない場合、自動的にキューに追加します）
lint	実装済み
remove <slug>	実装済み
queue <url> [<url> ...]	実装済み

スキルディレクトリ

この SKILL.md とすべての同階層ファイル（ingest.md、init.md、lint.md、remove.md、queue.md、ingest-protocol.md、templates/...）は、スキルディレクトリ内にあります。場所は ~/.claude/skills/pin-llm-wiki/、~/.copilot/skills/pin-llm-wiki/、~/.cursor/skills/pin-llm-wiki/、またはプロジェクトローカルの .claude/skills/／.copilot/skills/／.cursor/skills/ に相当するディレクトリです。このリポジトリでの正規コピーは skills/pin-llm-wiki/ です。このスキル内の templates/... と同階層ファイルのパスは、読み込みツールが使用したスキルディレクトリを基準とします。

ディスパッチ

1. 呼び出し引数（/pin-llm-wiki の後に続く最初の単語）からサブコマンドを特定します。
2. 振り分けます。このスキルディレクトリ内の同階層ファイルを読み、その指示に正確に従います。
   • init → init.md（wiki のひな形を作成するため、Guard は不要です）
   • ingest → ingest.md（URL 引数の有無を問いません）
   • lint → lint.md
   • remove → remove.md
   • queue → queue.md
3. Guard（init 以外のすべてのサブコマンド）： 現在の作業ディレクトリに .pin-llm-wiki.yml があることを確認します。存在しない場合は、次のメッセージを表示して停止します。「ここに wiki が見つかりません（.pin-llm-wiki.yml がありません）。まず /pin-llm-wiki init を実行して、ひな形を作成してください。」 サブコマンドのファイルでも参照によってこの確認を繰り返しますが、呼び出しごとに一度だけ適用すれば十分です。
4. 対象ファイルを読む前に、このディスパッチ手順を先に進めてはいけません。

Git ポリシー（正規）

会話内で人間からコミットを明示的に依頼されていない限り、サブコマンドの実行後に git commit または git push を実行してはいけません。対象となるサブコマンドは init、ingest、refresh、lint、remove、queue および自動修正です。サブコマンドのファイルでは、このポリシーを繰り返さずに参照しています。wiki 自身の AGENTS.md にも、後続のエージェント向けに同じルールが記載されています。