mcpField
L
llm-wiki-bootstrap

llm-wiki-bootstrap

github.com/nanzhipro生产力284 次安装
代码仓库

关于 llm-wiki-bootstrap

llm-wiki-bootstrap 是用于创建和维护个人 LLM Wiki 的技能，面向希望将资料整理为长期知识的用户。它将 raw/ 作为只读证据，并以 SCHEMA.md 作为 Wiki 的操作规范。

主要功能

  1. 01初始化 Wiki 结构和种子文件
  2. 02将来源编入衍生 Wiki 页面
  3. 03查询并引用 Wiki 内容
  4. 04检查 Wiki 健康状况与一致性
  5. 05可选配置 BM25 搜索

适用场景

  1. 01从头创建个人 Wiki
  2. 02将来源资料整理为维护页面
  3. 03通过引用 Wiki 页面回答问题
  4. 04检查并修复 Wiki 一致性

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nanzhipro/karpathy-llm-wiki-bootstrap-skill --skill llm-wiki-bootstrap

安装后在 Claude Code 中输入/llm-wiki-bootstrap确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/config/
extend-schema.md
references/templates/
agent-pointer.md
bm25-readme.md
concept-table.md
domain-page-types.md
extend.md
gitignore.md
index.md
log.md
overview.md
schema.md
wiki_fts.py
references/workflows/
bm25.md
bootstrap.md
ingest.md
lint.md
query.md

详细介绍

LLM Wiki 引导

构建并维护个人 LLM Wiki：原始证据在 raw/ 中保持不变，持久知识汇总到 wiki/ 中，而 SCHEMA.md 是生成的 Wiki 唯一的操作规范。

本文件有意保持简短。仅在执行用户请求的操作时，才加载详细参考资料。

操作模型

  • 在每个生成的 Wiki 中，将 SCHEMA.md 作为唯一事实来源。
  • 将 wiki/concept-table.md 作为维护中的概念图谱：它通过总结持久概念、关系、来源、状态和维护说明，对 wiki/index.md 进行补充。
  • 将 CLAUDE.md、AGENTS.md 和 .github/copilot-instructions.md 作为指向 SCHEMA.md 的精简指引；切勿在其中重复操作规则。
  • 将 raw/ 视为只读证据。仅在 wiki/ 下创建和更新派生知识。
  • 在执行引导、摄取、查询、检查或 BM25 相关工作之前，先应用 EXTEND.md 中的偏好。
  • 只询问尚未确定的事项；尽可能将设置问题合并到一条用户提示中。
  • 优先渐进式披露：读取足以完成当前任务的最少参考文件。

意图路由

用户意图执行操作参考资料
创建或引导新 Wiki运行偏好预检，收集设置答案，然后生成脚手架和种子文件。references/workflows/bootstrap.md
摄取一个或多个来源运行偏好预检，检查可选的 BM25 门槛，然后将来源知识汇总到 wiki/ 中。references/workflows/ingest.md
根据 Wiki 回答领域问题运行偏好预检，浏览 wiki/index.md，仅将 BM25 用作候选查找工具，然后引用 Wiki 页面。references/workflows/query.md
检查 Wiki 健康状况或一致性运行偏好预检，扫描结构和内容，报告发现，然后仅修复获准的项目。references/workflows/lint.md
配置或使用 BM25 搜索加载偏好设置，初始化前先询问，创建本地搜索文件，进行冒烟测试，并记录结果。references/workflows/bm25.md
配置偏好设置按照规范和模板查找或创建 EXTEND.md。references/config/extend-schema.md、references/templates/extend.md

偏好预检

在执行引导、摄取、查询、检查或 BM25 相关工作之前，读取 references/config/extend-schema.md，并按其中的查找顺序使用第一个可用的 EXTEND.md。如果不存在，则运行首次偏好设置，并根据 references/templates/extend.md 创建文件后再继续。

在会话中首次使用时，简要说明当前启用的偏好文件。不要默默使用默认设置。

参考资料加载规则

  • 对于引导初始化，先读取 references/workflows/bootstrap.md，然后仅在创建相应文件时加载各个模板。
  • 对于摄取、查询和 lint，先读取对应的工作流文件；只有在偏好设置或用户请求要求搜索行为时，才读取 references/workflows/bm25.md。
  • 对于架构生成，读取 references/templates/schema.md，并根据需要注入 references/templates/domain-page-types.md 中的领域片段。
  • 对于指针文件，读取 references/templates/agent-pointer.md，并确保生成的文件简洁。
  • 对于 BM25 初始化，仅在用户批准初始化后，才读取 references/templates/wiki_fts.py 和 references/templates/bm25-readme.md。

软件包布局规则

  • 如果技能自带的可运行辅助程序需要从已安装的技能软件包中执行，请将其放入 scripts/。
  • 将生成输出模板放入 references/templates/，即使生成的文件复制到用户的 wiki 后会变为可执行文件。
  • 将冗长的流程文档放入 references/workflows/，将配置架构放入 references/config/。
  • 在此技能中，references/templates/wiki_fts.py 是为生成的 wiki 中的 scripts/wiki_fts.py 准备的模板；技能不会直接执行该模板。

硬性规则

  • 未经用户明确批准，绝不覆盖现有 wiki。
  • 除在引导初始化期间创建 .gitkeep 等空的脚手架占位文件外，绝不修改 raw/ 中的文件。
  • 绝不直接根据 BM25 片段作答；先打开并阅读返回的 wiki 页面。
  • 摄取时保留源语言，除非用户要求使用其他 wiki 语言。
  • 每当 wiki 内容发生更改时，更新 wiki/index.md 并向 wiki/log.md 追加记录。
  • 如果搜索索引重建失败，保留 wiki 编辑内容、记录失败，并回退到使用 wiki/index.md 加文本搜索。

核心输出

成功引导初始化后，会创建一个包含以下内容的 wiki 根目录：

raw/
wiki/index.md
wiki/concept-table.md
wiki/log.md
wiki/overview.md
SCHEMA.md
.gitignore

可选输出取决于设置问题的回答和偏好设置：运行时指针文件、.vscode/settings.json、scripts/wiki_fts.py、indexes/ 和 exports/。

评论

支持 Markdown