企业官网建设流程全解析

PM Brain是一款面向产品经理的 Markdown「第二大脑」开源项目：它把访谈、会议记录、决策依据写进本地 Git 仓库的 Markdown 文件，让 AI 助手回答前先读「大脑」，每次周五再自动巡检。读不懂 Brain、Ingest、Provenance 这些词？这份 PM Brain 术语表指南带你 10 分钟通关所有核心概念。

为什么需要这份 PM Brain 核心概念清单？

PM Brain 的设计哲学非常克制：没有数据库、没有云端、没有向量嵌入，就是一堆你可以用grep搜索的 Markdown 文件。但它定义了一套独特的术语体系（Brain、Ingest、Hypothesis、Reversal Condition……），新手第一次读 docs/glossary.md 容易迷路。

这篇文章按「从核心到外围」的顺序，把这 10 个必知概念一次讲透。每个概念都附了它在仓库中的实际位置，方便你边读边查。

1. Brain：一个装 Markdown 文件的 Git 仓库

Brain（大脑）是 PM Brain 的第一核心概念，但它比你想的朴素得多：

你笔记本电脑上一个 Git 仓库里的 Markdown 文件文件夹。没有数据库、没有云端、没有 embeddings。你和你用的 Claude 都能读，就够了。

它的目录结构大致长这样（可参考 example-brain/ 这个预置示例）：

💡 关键理解：记忆住在你的仓库里，而不是住在 AI 里。这就是 Brain 和「聊天机器人记忆」的本质区别。

2. Ingest：把素材「喂进」大脑的标准流程

Ingest（摄入）指把一份素材——访谈转写稿、Slack 讨论串、一份文档、甚至聊天里的一句话——正式喂进 Brain 的过程。一次 Ingest 会做三件事：

1. 把原始文件复制到source/（从此不可修改）；
2. 在ingestion/写下结构化摘要：谁说了什么、什么日期、链接回原文；
3. 更新被这份新信号触及的持久层文件（假设、决策、干系人），一份素材常常触及 4~6 个文件。

你可以在终端里输入类似/ingest transcript.md的命令，也可以直接把一句话丢给 Agent：「记录一下：今天站会上工程负责人反对 Q3 范围」。

3. Provenance：每条论断的「出身证明」

Provenance（出处/溯源）是 PM Brain 最有特色的概念之一：Brain 里每一条承重的论断都戴着一个「标签」，标明它多可信、去哪核实。

完整标签体系定义在 docs/glossary.md，按可信度从高到低排：

📌 为什么要这么较真？同一个「我们需要暗黑模式」的说法，如果只来自某个干系人的口头一句话，和来自 27 次有记录的访谈，分量完全不同。Provenance 标签让这个差异白纸黑字可见。

4. Hypothesis：带着状态机运转的假设

Hypothesis（假设）是你对产品、用户或市场的一句话判断，你会持续追踪支持或反驳它的证据。每条假设存放在hypotheses/下独立文件中，随证据积累在状态之间流转：

• candidate：刚建立，可能只有一条观察
• proposed：已有两三条独立观察
• validated：证据充分，可以行动
• demoted：被证据推翻，留档但不参与规划
• archived：已解决或过期，退出活跃轮转

文件模板见 hypotheses/_SCHEMA.md。

5. Decision File & 6. Reversal Condition：只增不删的决策记录

Decision File（决策文件）是decisions/下对一个真实决定的记录：决定了什么、当时有什么证据、考虑过哪些替代方案。它的精神是只追加（append-only）——情况变了不会悄悄改写历史，而是新增一条链接回旧决策的记录。

每个决策文件还必须写明Reversal Condition（重开条件）：一个具名的、具体的触发条件，满足它才重新打开这个决策。例如：

「如果有 3 笔确认丢掉的单子都把强制 SSO 列为首要障碍，重开这个决策。」

而不是含糊的「如果情况有变」。没有重开条件，决策要么被随意反复推翻，要么被当成不可更改的圣旨。

7. Watch Item & 8. Drift：大脑的「体检信号」

Watch Item（观察项）：有趣但还不够格行动的信号。Agent 会把它记下来、挂到相关决策或假设上，等你在/review时检查。例如 CEO 在 1:1 里随口说「SSO 的事也许要重新考虑」，而正式决策是延后 SSO——这就是一个 Watch Item。

Drift（漂移）：一条假设挂了很久，证据既不增加也不减少。/review会标记出漂移的假设，让你决定：复活、降级，还是归档。

另外两个高频词一并记住：

• Contradiction（矛盾）：Brain 里两份证据指向相反方向。Agent 只负责暴露矛盾，不负责裁决——判断永远留给你。
• Audit Trail（审计轨迹）：从 Brain 里任意一条论断一路点回原始素材的链接链。它让大脑六个月后依然有用：你不仅能查到「当时决定了什么」，还能查到「当时知道什么」。

9. 六个核心命令：术语如何落地成操作

概念最终要通过命令用起来。PM Brain 一共六个命令（详见 docs/glossary.md 的命令表）：

10. Evidence Hierarchy：证据打架时听谁的？

当两份证据冲突时，PM Brain 内置一套默认的证据优先级（来自 docs/glossary.md）：

书面决策 > 书面调研 > 书面干系人陈述 > 口头干系人陈述 > PM 直觉

这不是铁律，而是默认值。当优先级低的证据与优先级高的冲突时，Brain 会把两边都摆出来并标注差距，怎么处理由你拍板。

附赠：三种安装模式 + 自检，一分钟看懂

装 Brain 前还有三个常见词：

• Migration mode（迁移模式）：在有存量 PM 素材的目录（Notion 导出、会议笔记文件夹）里运行/pm-brain，Agent 会先简短访谈你的公司/角色/优先级，再吸收现有内容生成初始 Brain。⚠️ 注意：迁移的是「当前状态」，不要回头补录 200 份旧访谈。
• Greenfield mode（绿地模式）：在空目录里运行/pm-brain，同样先简短访谈，然后从零搭脚手架。
• Self-test（自检）：脚手架搭好后 Agent 会跑一次「模拟 Ingest」，验证读、写、Provenance 打标三条链路。装错的话，你一分钟就能发现，而不是一个月后。

术语表小结：一张图记住 PM Brain 的核心概念

掌握这 10 个核心概念，你就可以直接上手：先跑一遍 docs/walkthrough.md 的一周故事，再读 docs/why-this-matters.md 理解背后的设计取舍。术语只是地图，你的 Brain 才是目的 🧠