SuperAPI AI 工具集

knowledge

写作与研究

查看项目

更新于 10-16 02:03

技能介绍

Knowledge 是 doctrine 体系中的知识记录模块,定位为项目的“认知之家”——用带类型、可引用的实体记录项目所相信、所选择、所疑问、所观察或所受约束的内容。这些记录塑造工作,但它们本身不是工作项。

用途与归属

doctrine 用一条线划分四类记录的家:工作意图 → backlog;认知状态 → knowledge record;架构决策 → ADR;智能体指引 → memory。具体归属可参考 lib:reference/using-doctrine.md 的“Which home for which record”一节。

记录类型

Knowledge 按表述形态区分七种类型:

  • “以 X 为前提推进”(未经验证的前提)→ 假设(ASM)
  • “我们选择 X 而非 Y”(有范围或操作性)→ 决策(DEC)
  • “未解决——X?”(需要答案)→ 问题(QUE)
  • “受 X 约束”(外部施加的限制)→ 约束(CON)
  • “观察到——X”(可引用的观察)→ 证据(EVD)
  • “可检验的主张 X”(等待证据)→ 假说(HYP)
  • “稳定的心智模型/术语 X”→ 概念(CPT)

DEC 还是 ADR?具有架构后果且项目全局性的内容应使用 doctrine adr new;有范围或操作性的内容使用 DEC。

使用方式

命令行是精确参数和各类型状态词汇的唯一来源,可通过 doctrine knowledge --help 查看。动词列表和参数可参考 doctrine knowledge --help、doctrine link --help 和 doctrine supersede --help。用 shapes 边把记录关联到它所塑造的工作(spawns 用于它引发的工作);证据边使用 supports 或 disputes。

记录 ID 前缀在读取和状态转换时会解析出类型,参见 doctrine knowledge show --help。捕获(Capture)会写入该类型的默认状态(held、proposed、open、active 等)。不要手工编辑记录 TOML(参见 lib:reference/using-doctrine.md 的存储层级说明),应使用命令行动词;正文 Markdown(*.md)可以手工编辑。

放错家了吗?

工作意图(bug / improvement / chore / risk / idea)→ /backlog。可复用的智能体指引、配方或注意事项 → /record-memory。判别标准:知识记录是关系图中可引用的认知实体——可关联、可门控、可取代;memory 是面向智能体的检索层指引。同一条线也区分 CPT 与 memory 概念:CPT 命名其他实体会引用的稳定项目概念;memory 解释如何思考或工作。

门控

关联不等于门控。知识记录的门控机制(needs、settle-to-unblock)参见 lib:reference/using-doctrine.md 的“Which home for which record”一节。

限制与注意事项

资料未提供该模块的收费、价格、平台支持范围或具体效果等信息。记录 TOML 不应手工编辑,正文 Markdown 可手工编辑。