SuperAPI AI 工具集

open-knowledge-pack-knowledge-base

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:这是 Knowledge Base 起始包(knowledge-base starter pack)的工作流指南,适用于采用三层 source-grounded 布局的项目。核心是闭环证据链:任何 canonical 内容都必须能追溯到被保存的原始来源。该技能只承载工作流,模板与 log.md 保持干净;平台 open-knowledge 技能(读写、预览、链接、grounding 规则)仍管辖所有 markdown 操作。

三层结构:external-sources/ 保存逐字原始来源(由 ingest 产生);research/ 存放临时分析(由 research 产生);articles/ 存放经决策后的 canonical 知识(由 consolidate 产生)。循环为 ingest → research → consolidate。下游论断须向上游追溯到 external-sources/ 中的本地路径,不要只写裸网页 URL,以保证知识库不因链接失效而损坏。

主要能力与用法:创建页面时即建立链接(至少 hub/index 页与最相关同级页),相关页共享 frontmatter 的 cluster 值以便图谱着色。三个过程各自独立成技能,按需加载:ingest 位于平台 open-knowledge 技能(references/ingest-and-sources.md),用于逐字保存 URL/PDF/文件;research 由同级技能 open-knowledge-pack-knowledge-base-research 承担,产出 status: provisional 文章并列出 sources;consolidate 由同级技能 open-knowledge-pack-knowledge-base-consolidate 承担,在决策落地后提交 canonical 文章并带 supersedes 链。不要静默串联:ingest 后询问是否进入 research,research 后由用户决定是否 consolidate。过程的 STOP 门(research 的范围门、consolidate 的决策确认门)不被会话级“不要停下来提问”提示覆盖。

各目录规则:external-sources/ 逐字保存抓取文本、PDF 提取文本或文件副本,frontmatter 记录原始 URL、访问日期与作者/出版者元数据,捕获后不可变,仅可刷新过期抓取,不放分析。research/ 为综合外部来源的临时分析,每条事实性论断须引用 external-sources/ 中具体文档,sources 列表与正文链接保持一致。articles/ 为团队决策后的 canonical 知识,带 supersedes 链指回被替代的 research 文档,仅在出现新决策时更新。状态流:research 创建时 status: provisional,articles 经 consolidate 提升后 status: canonical。

日志纪律(必须):项目根目录有 log.md,任何创建、编辑或重构内容的回合后追加一条带日期条目,每回合一条而非每文件一条。记录 ingest、research/consolidate、三过程之外的直接写改移删、项目上手、目录重构与 .ok/config.yml 变更。引用文档用 markdown 链接而非裸路径,以便出现在 backlinks 中。条目形如:## YYYY-MM-DD: 标题,下列出所做事项、Files touched、Sources ingested、Open follow-ups。

模板:每个文件夹有起始模板(clip、research-log、article),用 write({ document: { path, template: "<name>" } }) 创建;模板只含结构与 frontmatter 骨架,字段含义见上述说明。

限制:资料未提供具体安装命令、收费、平台支持范围或效果数据;该技能为 pack 指南,不替代平台 open-knowledge 技能。