用途:建立持久、以文件为载体的知识系统,把团队共享上下文、决策、规则和开放问题集中在一处。该里程碑为静态优先,不使用 hooks、MCP、自定义工具或运行时记忆引擎,仅依赖 Markdown 文件、链接和明确归属。
适用场景:为产品或领域启动知识库;把分散的规划笔记整理为规范文件;将重复出现的上下文沉淀为稳定规则与参考;围绕领域建立决策、质量与评审链接。
规范输入:templates/knowledge/index.md、domain.md、knowledge.md、hypotheses.md、rules.md,以及 docs/knowledge/README.md;相关记录包括 templates/decisions/decision.md、templates/quality/gate.md、templates/review/maintenance-review.md。
目标结构:docs/knowledge/ 下含 README.md、index.md、domains/<domain>.md、entries/<topic>.md、hypotheses.md、rules.md。
工作流:定义范围(覆盖哪个产品、系统或领域,哪些应持久、哪些仍不确定);从模板创建索引,记录领域、关键知识、规则、开放假设与关联记录;按领域建文件并明确边界;用 knowledge 模板记录持久事实、模式或参考,倾向小条目强链接;用 hypotheses 模板跟踪需验证的主张,每条假设应有负责人或下一步验证;用 rules 模板写稳定运行规则,尽量链接证据、决策或既往事件;稳定选择放入 docs/decisions/,可重复检查放入 docs/quality/,周期性健康检查放入 docs/reviews/maintenance/。
写作规则:标题简洁,一文件一想法,标记不确定性而非隐藏,横向链接知识、决策、质量与评审,避免会话性闲聊。
完成标准:index.md 存在或已更新;核心领域已列出;持久知识与假设分离;规则明确;相关决策、门禁与评审已链接。
反模式:无差别巨型笔记;规则无理由;决策埋在随机会议记录中;把假设当作既定事实;在里程碑 1 中假设运行时工具。
限制:资料未提供具体安装命令、收费、价格、平台或效果信息。