用途
Knowledge Base 技能包用于指导在采用“来源可追溯”三层布局的知识库项目中工作。其核心目标是形成闭环证据链：任何正式知识都必须能追溯到被完整保存的原始来源。该技能承载工作流，使模板与 log.md 保持整洁——从模板创建文档时获得结构，而“如何做”的说明放在本技能中。
该技能是技能包层面的指导。平台的 /open-knowledge 技能（读写、预览、链接、grounding 规则）仍然管辖每一次 Markdown 操作，本技能在其之上叠加知识库工作流。
主要能力
创建时即链接
用户会实时观看构建过程——编辑器跟随正在写入的文件，知识图谱随着页面被链接而在屏幕上组装。无需进行视图管理，只需良好地撰写：每个页面从写入那一刻起就携带其链接（至少包含 hub/index 页面及其最相关的同级页面——未链接的页面在图谱中不可见），相关页面共享一个聚类：frontmatter 值（例如 cluster: architecture），使图谱的聚类着色让地图一目了然。
三层结构
external-sources/ 原始来源，逐字保存（由 ingest 产生） ↓ cite research/ 临时分析（由 research 产生） ↓ promote articles/ 正式、已决定的知识（由 consolidate 产生）
循环为 ingest → research → consolidate，对应 Karpathy 的三层知识库模式。每个下游主张都向上游追溯到被保存的来源。引用 external-sources/ 中的本地路径，绝不使用裸 Web URL——知识库必须能在链接失效后存活。
Karpathy 的洞见：“维护知识库中繁琐的部分不是阅读或思考——而是簿记。”人类放弃 wiki 是因为维护成本超过感知价值。这些流程的存在是为了让智能体能够不知疲倦地完成簿记（抓取、总结、交叉链接、取代）。跳过交叉链接、取代链或原始来源保存，正是把有用的 wiki 变回被遗弃 wiki 的原因。
使用方式
三个流程
每一层都有一个完整的、带 STOP 门控的流程，且各自作为独立技能发布，以便只在工作需要时加载。当工作适合某一层时，使用 OK 动词自行执行流程，这是相对于裸 write 的默认动作。
| 流程 | 所在位置 | 何时使用 |
|---|---|---|
| ingest | 平台 /open-knowledge 技能（references/ingest-and-sources.md）——其 Grounding 规则在各处都依赖它，因此随每个项目发布，而不仅是本技能包。 | 逐字保存共享的 URL / PDF / 文件，或者你抓取了一个 URL 来为知识库主张提供依据（二进制来源被保存，而非抓取）。 |
| research | 同级技能 /research-with-sources | 调查 / 比较 / 综合多个来源 → 生成带 status: draft + sources: 的临时文章。 |
| consolidate | 同级技能 /consolidate-notes | 实际做出决定 → 提交带 status: stable + supersedes: 链的正式事实来源。 |
典型的第二天流程：用户分享一个 URL → ingest（保存）→ 用户问“现在研究这个” → research（临时文章，按需摄取更多来源）→ 决定落地 → consolidate（正式文章，取代研究）。
不要静默地串联。ingest 之后，询问是否继续 research。research 之后，让用户决定发现是否已准备好 consolidate。每个流程按自身条件完成——用户驱动转换。
自主门控 vs 会话级自主。流程的 STOP 门控（research 的范围界定门控、consolidate 的决定确认门控）不会被会话级“不停下来问澄清问题”的提示覆盖。那些提示覆盖琐碎的来回（“你指的是哪个文件？”）；门控存在是为了单向门决定。如有疑问，门控具有权威性。
各文件夹规则
external-sources/ —— 原始来源逐字保存，而不仅仅是引用：URL 的实际抓取文本、PDF 的提取文本、被引用文件的副本。每个文件的 frontmatter 携带原始 URL、访问日期以及任何作者/发布者元数据。由 ingest 流程产生（无论用户分享 URL 还是你自己抓取 URL 来为某主张提供依据，都适用）。捕获后不可变——仅在刷新过时抓取时更新。此处不做分析；分析属于 research/。
research/ —— 综合外部来源的临时分析，以 OKF status: draft 存储。由 /research-with-sources 技能产生。每个事实性主张都引用 external-sources/ 中的特定文档（如果跳过 ingest，则引用内联 URL）；不允许无来源的断言。保持 sources: frontmatter 列表与正文中实际链接的文档一致。一旦团队决定发现稳定，通过 /consolidate-notes 技能提升到 articles/。
articles/ —— 正式知识，在团队决定后提交，以 OKF status: stable 存储。由 /consolidate-notes 技能产生。携带 supersedes: 链，指回它所取代的 research/ 文档（后者又引用 external-sources/），因此完整证据链无需离开仓库即可追溯。该领域的事实来源；仅当新决定取代它时才更新。
状态流转
| 层 | status | 设置时机 |
|---|---|---|
| research/ | draft | 创建时 |
| articles/ | stable | 决定后由 consolidate 提升 |
当新文章取代研究时，将该研究设为 status: deprecated，将其路径加入文章的 supersedes: 列表，并用 superseded_by: 指回。
旧版兼容
较旧的项目可能使用 status: provisional / canonical 以及 sources: 下的字符串条目。将这些形式读作 draft / stable 和 source 资源。不要重写未触及的文档；对新写入和已在更新的文件使用上述 OKF 形式。
日志纪律（必须）
项目根目录有一个 log.md。在任何创建、编辑或重构内容的回合之后追加一条带日期的记录——每回合一条，而非每文件一条。静默编辑会破坏审计轨迹。
记录：ingest 运行（新来源）、research / consolidate 运行（临时或正式文章）、三个流程之外的直接写入 / 编辑 / 移动 / 删除、项目入职运行、文件夹重构以及 .ok/config.yml 变更。
将参考文档作为 Markdown 链接引用，而非裸路径——path/to/doc，这样该条目会出现在这些文档的 links({ kind: "backlinks" }) 中。裸路径字符串不会在图谱中注册。
由于这个仅追加的 log.md 是保留日志，其损坏链接可能会被从审计中隐去。当干净结果携带 brokenLinkSuppression 时，它是被过滤而非证明每个原始链接都能解析；不要重写日志历史来清除这些链接。
条目形式：
YYYY-MM-DD: <short title>
- <what was done>
- Files touched: doc-a, doc-b
- Sources ingested: source-slug
- Open follow-ups: <topic-1>, <topic-2>
模板
每个文件夹都有一个起始模板（clip、research-log、article）。使用 write({ document: { path, template: "<name>" } }) 创建。模板只携带结构（标题 + frontmatter 脚手架）——每个字段和章节的含义在上面描述，不在文档正文中重复。
适用场景
适用于采用三层来源可追溯布局的知识库项目，尤其是需要智能体协助完成抓取、总结、交叉链接与取代等簿记工作的场景。典型流程为用户分享 URL 后依次进行保存、研究与正式化。
限制
该技能本身不定义 Markdown 读写、预览、链接与 grounding 规则，这些由平台 /open-knowledge 技能管辖。流程的 STOP 门控不可被会话级自主提示覆盖。具体模板内容、字段含义与状态值需遵循上述规则，缺失信息暂未提供。