mcpField
L
llm-wiki

llm-wiki

github.com/godstale生产力649 次安装25 周前更新
代码仓库

关于 llm-wiki

llm-wiki 是一项 Agent 技能，用于摄取、查询、维护项目知识并生成关系图。它通过互相关联的 Wiki 页面和生命周期命令，整理来源与综合答案。

主要功能

  1. 01将来源内容摄取为 Wiki 页面
  2. 02查询页面并提供链接引用
  3. 03保存综合查询答案
  4. 04检查失效链接和过时摘要
  5. 05构建知识图谱

适用场景

  1. 01整理笔记和来源文档
  2. 02查找 Wiki 页面中的信息
  3. 03检查 Wiki 链接与摘要

安装

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

$npx skills add https://github.com/godstale/llm-wiki --skill llm-wiki

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

包含的文件

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

LICENSE
CHANGELOG.md
GEMINI.md
.gitignore
README.md
CLAUDE.md
AGENTS.md
README.ko.md
references/
graph-html.md
folder-managing.md
ingest-advanced.md
ontology-commands.md
query-advanced.md
ontology-template.yaml
ontology-data-template.yaml
templates.md
ontology-interview.md
scripts/
file_to_markdown.py
lint.py
query_filter.py
ontology_validate.py
requirements.txt
build_graph.py
test/ontology_test/
scala.md
test/ontology_test/wiki/
ontology-registry.md
test/ontology_test/wiki/ontologies/
scala.yaml
test/wiki_test/
Test_Result.md
test/wiki_test/raw_test/
AI_개발_학습_자료.json
AI_개인_프로젝트_목표.json
베트남_여행_항공권.json

详细介绍

LLM Wiki：Agent 操作规范

这是 LLM Wiki 项目的主要“操作手册”，负责管理知识的生命周期：摄取 → 查询 → 检查 → 图谱。

🧭 核心工作流索引

详细说明请参阅相应的参考文件。

阶段操作参考
摄取/wiki-ingest [<file>|--from <dir>]references/ingest-advanced.md
查询/wiki-query <question>references/query-advanced.md
保存/wiki-synthesize [slug]SKILL.md#wiki-synthesize
维护/wiki-lint | /wiki-graphSKILL.md#maintenance
编辑/wiki-update | /wiki-deleteSKILL.md#lifecycle
本体/wiki-ontology-*references/ontology-commands.md

🏗️ 项目布局

wiki/
  index.md          # Catalog of all pages (Update EVERY ingest)
  log.md            # Chronological record (Append-only)
  history.json      # Ingest registry (Always use Write tool)
  sources/          # Summaries (kebab-case.md)
  entities/         # People/Projects (TitleCase.md)
  concepts/         # Ideas/Theories (TitleCase.md)
  syntheses/        # Saved query answers
  originals/        # Read-only archive
  ontologies/       # (OPTIONAL) Structured YAML data

模板与架构 → references/templates.md | Wiki 链接：[[PageName]]（区分大小写）

📥 摄取流程

主要目标： 将原始输入转换为结构化的 Wiki 页面，并归档原始文件。

  1. 分析： 阅读来源，确定标题和 slug。
  2. 策略： 选择模式（完整模式或仅摘要模式）。
    • 仅摘要模式： .xlsx、.pptx、超过 30 页的 .pdf，或使用 --summary-only 标志。
  3. 执行：
    • 写入 wiki/sources/<slug>.md。
    • 使用分层分类更新 wiki/index.md（例如 Hobby/Cycling）——规则和默认设置请参阅 references/ingest-advanced.md。
    • 创建或更新 wiki/entities/ 和 wiki/concepts/。
  4. 登记： 更新 wiki/history.json，并在 wiki/log.md 中追加记录。

高级标志（--to、--precision、--no-interview 等）→ references/ingest-advanced.md

🔍 查询与综合

/wiki-query
  1. 从 wiki/index.md、wiki/synthesis-map.md 和 wiki-hub.md 中查找相关页面。
  2. 从 sources/、entities/、concepts/ 和 ontologies/ 收集上下文。如果文件位于 wiki-hub.md 中，请引用外部来源仓库。
  3. 使用 [[PageName]] 引用综合答案。 结构筛选器（class:、type:、AND/OR）→ references/query-advanced.md
/wiki-synthesize

将上一次查询的答案保存到 wiki/syntheses/<slug>.md。

  1. 根据问题生成 slug。
  2. 更新 wiki/synthesis-map.md（仅追加）和 wiki/log.md。

🛠️ 维护与生命周期

#maintenance
  • /wiki-lint：检查孤立页面、失效链接和过时摘要。（报告：wiki/lint-report.md）。如果存在 wiki-hub.md，忽略或降低从导入的外部文件指向的失效链接的严重级别。
  • /wiki-graph：重建 graph/graph.json 和 graph/graph.html。
#lifecycle
  • /wiki-sources：列出 history.json 中已摄取的来源。
  • /wiki-update ：从原始文件刷新来源。
  • /wiki-delete ：软删除来源（保留在历史记录中，移除页面）。

🔗 Wiki-Hub 架构支持

当项目根目录存在 wiki-hub.md 文件时，它将作为外部文件的权威注册表。

1. 外部来源引用
  • 执行 /wiki-query 时，Agent 必须检查 wiki-hub.md 中是否列出了答案所用的文件。
  • 如果文件被列为导入来源，引用应包含外部仓库信息（例如 [[PageName]] (Source: repo-name)）。
2. 检查例外
  • /wiki-lint 应读取 wiki-hub.md 中的 ## Imported Sources 列表。
  • 对于 Hub 中列出的文件，应抑制失效链接警告或将其标记为“External”，以避免由指向未导入依赖项的链接造成不必要的噪声。
3. 文件完整性
  • 未经用户明确确认，不得覆盖、修改或删除 wiki-hub.md 跟踪的文件。这些文件由 Hub 在外部管理。

⚠️ 注意事项与关键规则

  • 只读： 不得修改 wiki/originals/。
  • 一致性： 每次摄取都必须更新 wiki/index.md，以确保查询发现功能正常。
  • 历史记录： 始终对 wiki/history.json 执行读取、合并、写入。
  • 清理： 删除时，检查是否有孤立的实体或概念页面。

评论

支持 Markdown