XK-Knowledge

一个基于本地仓库的知识库 MVP，用来把 RAW/ 中的原始材料整理为 WIKI/ 中可检索、可引用、可审计的知识页面。

• Ingest：把单个 RAW/*.md 整理并写入知识库
• Query：基于本地 WIKI/、INDEX.md、LINK.md 回答问题
• Check：对单个 wiki 页面做只读审计，输出 markdown 报告

核心原则

项目行为受 CONSTITUTION.md 约束，最重要的几条是：

• 只有当前 RAW 文档支持的知识才能写入仓库
• 不允许引入外部事实或未被当前 RAW 支持的推断
• 每个写入的结论都必须能追溯到至少一个 RAW chunk
• index / link 也必须保守、基于证据
• 审计结果只读，不自动修复、不自动改写文件

功能概览

1. Ingest

把一个 RAW 文档整理成知识库内的原子提交，通常会写入：

• wiki 页面
• WIKI/INDEX.md
• WIKI/LINK.md
• LOG/

• 一次只处理一个 RAW 文件
• 依赖当前 Claude 会话生成 mutation 内容
• 本地 runtime 只负责 prepare / validate / commit
• 不在脚本内部启动 Claude 或其他二次模型调用链路

2. Query

从本地知识库检索并回答问题。

• 先看 WIKI/INDEX.md
• 需要时通过 WIKI/LINK.md 扩展一跳
• 读取相关 wiki 页面
• 返回答案，并附带页面引用和 Raw chunk 依据

在 Claude Code 里直接自然语言提问即可，例如：

3. Check

对单个 wiki 页面做显式审计。

• 一次只检查一个 WIKI/*/pages/*.md
• Phase 1：检查 RAW ↔ WIKI 表达一致性
• Phase 2：在 Phase 1 完成后，再做最小 INDEX/LINK 全局检查
• 只返回审计报告
• 不写 wiki、不写 index/link、不写 log

返回内容是人读 markdown 报告，典型结构如下：

最常用的使用方式

1) 新增知识

• 新增文章导入
• 已有 RAW 需要转成 wiki 页面
• 需要同步补全 index / link / log

2) 查询已有知识

• 查某个主题已有结论
• 看相关页面和一跳关联
• 基于现有 wiki 做简短问答

3) 审计单页质量

当你想检查某个 wiki 页面是否在证据边界内表达稳妥：

• 检查页面是否有无来源陈述
• 检查页面是否有过强结论
• 检查与该页面直接相关的最小 link 关联是否正确

输入约束

/xk-ingest

• 输入必须是单个仓库相对路径
• 必须位于 RAW/ 下

Query

• 问题应尽量围绕本地知识库已有主题
• 如果 INDEX.md 找不到相关页面，回答会偏保守

/xk-check

• 输入必须是单个仓库相对路径
• 必须位于 WIKI/*/pages/*.md
• 当前版本不支持直接传文件夹或全仓扫描