pin-llm-wiki

/pin-llm-wiki

自动化 Karpathy 的 LLM wiki 模式：将 URL 放入 inbox.md，该技能会抓取、摄取并维护一个带引用、可供 Agent 读取的知识库。

触发短语

• /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 尚未位于收件箱中时自动将其加入队列）
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/pin-llm-wiki/。此技能中的所有 templates/... 和同级文件路径，均相对于加载工具所使用的技能目录。

调度

1. 根据调用参数识别子命令（/pin-llm-wiki 后的第一个词）。
2. 路由——读取此技能目录中的同级文件，并严格遵循其说明：
   • init → init.md（不需要 Guard——它会搭建 wiki）
   • 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 对下游 Agent 也规定了相同规则。