跳转到内容
KnowFlow logoKnowFlow

配合 AI 助手使用

你从来不需要自己动手整理——这正是 KnowFlow 的意义：让一个能读写文件的编码 agent（ZCode、Codex CLI、Claude Code、OpenCode，任何都行）起草，把判断权留给你。它们执行的是同一份成文契约，换 agent 不换结果。

循环长这样

Section titled “循环长这样”
你保存 ──► raw/ ──► agent 合成 ──► 你审核 ──► 图谱 + 检索
             │       （同一份契约）    （一个词）
             │
             └─ raw/ 永不被改写；待审页进不了图谱和检索索引
  1. 存。 把文章、推文、笔记存进 raw/——自己跑 knowflow ingest，或者直接让 agent 代跑。采集不碰任何 LLM。
  2. 合成。 agent 遵循合成契约——knowflow init 已把它物化到工作区 docs/agents/synthesize.md，AGENTS.md 指针小节是零配置入口（上游母本）：每个 raw 文件一张 status: pending 的 source 页，新出现的实体补最小 entity 页，frontmatter 带 created_from 溯源，核心要点带 (EXTRACTED)/(INFERRED) 置信标注，严格 wiki 根相对 [[wikilinks]]。knowflow compose --list 会准确告诉它还剩什么没合成。
  3. 审。 通过一张页面只需改一个词——pending 改成 reviewed；驳回就删文件。概念页和对比页只在人显式点名时才合成。
  4. 验、看。 knowflow health 和 knowflow check 校验本批页面；knowflow graph 与 knowflow index build 跳过待审页——图谱和检索索引里永远只有你审核过的内容。

一段可直接粘贴的提示词

Section titled “一段可直接粘贴的提示词”

把下面这段给你的 agent 就能跑起来：

你负责维护我的 KnowFlow wiki，工作目录是本项目根目录。


读取本工作区的 KnowFlow 合成契约 docs/agents/synthesize.md
（knowflow init 已物化），严格按契约执行。


任务：
1. 跑 `knowflow compose --list`，看哪些 raw 文件还没有对应页面。
2. 按契约合成：`status: pending` 的 source 页加最小 entity 页，
   直接写进各自的最终目录。
3. 跑 `knowflow health` 和 `knowflow check`；只修你本批创建的页面。
   绝不运行不带 --dry-run 的 `knowflow fix`。
4. 汇报你创建了什么、建了哪些链接，供我审核。

（如果契约就在本地——knowflow 仓库的检出，或你拷进项目里的一份——让 agent 读本地路径即可，不必用 URL。）

一个完整的例子

Section titled “一个完整的例子”

假设你存了一篇讲检索增强生成（RAG）的文章：

  • agent 创建 wiki/sources/rag-article.md——一张 status: pending 的出处记录，每条核心要点带 (EXTRACTED) 或 (INFERRED) 标注。
  • 对文章新引入的实体，它起草最小 wiki/entities/… 页，并从 source 页的「提取的实体」章节链过去。已存在的实体页只链接、绝不改写。
  • 概念页不会自己冒出来——概念只在人显式点名时才合成（比如「给 RAG 建概念页」）。
  • 你来审核：把页面翻成 reviewed，或删掉某张即驳回。此后 knowflow graph 和 knowflow index build 才会收录它们。

下个月另一篇 RAG 文章进来，agent 用同样的方式起草第二张 source 页——图谱越长越密。跨来源的内容级去重还在路线图上；眼下同一 URL 采集两次产生两张 source 页是设计内行为。

几条经验

Section titled “几条经验”
  • 小批量。 契约允许批量合成，但一次一小撮 raw 文件，审核才快得起来。
  • 先试运行再修复。 health 对不是 agent 本批创建的页面报问题时，让它跑 knowflow fix --dry-run 给你看——绝不裸跑 knowflow fix。契约明令禁止：真修复会改写已审页面，而审阅权在你。
  • 信任闸门。 待审页被 graph 和 index build 跳过、被 health 豁免孤儿判定、被 fix 永不触碰。未审核的工作漏不进图谱和检索索引。
  • 助手随便换。 契约就是一个纯 Markdown 文件——ZCode、Codex CLI、Claude Code、OpenCode 读到的是同样的话，落到同样的结果。
  • 开着 Git。 git diff 就是你的审核界面——每一轮合成都是可读、可回滚的 diff。