makerskills 之 company-brain:如何为团队构建 AI 就绪的共享知识库(完整指南)

原创2026-10-25 16:12:361,679 阅读

makerskills 之 company-brain:如何为团队构建 AI 就绪的共享知识库(完整指南)

makerskills 是一款面向 Claude Code、Codex、Cursor 等 AI Agent 的开源技能集,其中的 company-brain 技能专为团队打造了一个 AI 就绪(AI-ready)的共享知识库:把团队成员、客户公司、会议记录、SOP、决策记录结构化归档,让 AI Agent 能以团队的口吻、基于团队的真实知识来回答问题。它支持多人协作、信任分级与敏感度控制,是销售型、运营型团队把"散落的经验"变成"可查询资产"的完整方案。

一、为什么团队需要 AI 就绪的知识库?

很多团队的知识散落在各种角落:

  • 📞 客户电话的录音和转录,说完就没人再看
  • 💬 Slack / 邮件里讨论过的决策,几周后就查不到
  • 📄 SOP 写在某个人的脑子里或一个没人维护的文档里
  • ❓ 客户反复问的同一个问题,每次都重新回答

company-brain 的核心思路是:知识先自由捕获,再定期审核,最后编译成 AI 可查询的 Wiki。它让"团队知道什么"变成一件可检索、可追责、可更新的事——这正是"AI 就绪"的含义:数据结构化、来源可追溯、质量有分级,AI 的回答才靠得住。

💡 简单理解:捕获(capture)→ 编译(compile)→ 查询(query),三层流水线,AI 负责搬运和整理,人负责把关。

二、company-brain 是怎么工作的?

company-brain 是 makerskills 中 second-brain(个人版知识库)的团队版姊妹技能,完整定义见 SKILL.md。它采用同样的三层结构,但原始层是按业务分类的结构化目录,而不是平铺一堆笔记:

raw/(结构化原始层)  →  wiki/(编译层)  →  outputs/(产出层)
  按类别归档的笔记        互相链接的 Wiki 页面      生成的问答与交付物

1. 结构化原始目录:信息各归其位

团队的信息按类型直接落入对应的顶级目录(详细命名规范见 references/schema.md):

目录 存什么
people/ 带上下文的联系人档案(轻量 CRM),一人一个文件
companies/ 公司档案:最后触点、机会规模、状态
meetings/ 电话/会议转录与笔记,命名如 2026-06-15-acme-discovery.md
sops/ 标准作业流程,如 sales-outbound-cadence.md
decisions/ 决策记录(叙述形式,含结果与复盘)
customer-language/ 客户/潜客的原话,直接滋养文案与营销
recurring-questions/ 被问了 3 次以上的问题,自动沉淀为 FAQ/SOP
sales-objections/ 销售异议库 + 最佳回应,拼装成销售话术
raw/ 未分类的兜底目录(尽量少用)

2. 多作者纪律:每条信息都有署名

每一条捕获内容都自动盖上"四个戳":

source: 与 Acme 的电话(2026-06-30)
author: @alex
captured: 2026-06-30
trust: unreviewed

Wiki 页面的来源部分也会标注文件和贡献者,只追加、不覆盖。谁贡献了什么、什么时候贡献的,一目了然——这是团队级知识库可信的基础。

3. 信任分级:垃圾信息不会污染 AI 的回答

这是 company-brain 最关键的设计。每条内容都有一个 trust 字段,四种状态:

信任级别 含义 查询时的处理
unreviewed 已捕获但没人确认(默认) 可用,但答案会标注"置信度较低"
verified 人工审核过 全权重使用
deprecated 错误或过时 永不作为上下文,仅为历史保留
superseded 被新内容取代(带 superseded_by 指针) 永不使用,查询时指向替代内容

⚠️ 核心原则:宁弃勿删(Deprecate, don't delete)。信息错了不删除,而是标记降级——历史得以保留,AI 上下文得到保护。配合定期执行的 /cb review 审核通道,捕获可以完全自由,但只有审核过的信息才拥有全权重。

4. 敏感度控制:机密内容只给该看的人

每条内容还可标记敏感度:internal(全员可见,默认)、leadership(仅管理层)、confidential(指定名单)。查询模式下 AI 会先识别调用者身份,拒绝包含超出其权限的内容;Wiki 页面则继承其来源中的最高敏感度。信任与敏感度相互独立:一条内容可以既是 verified 又是 confidential。

三、快速上手:如何搭建团队 company-brain

第一步:安装 makerskills

在 Claude Code 中执行(或按 INSTALL.md 配置环境变量):

/plugin marketplace add coreyhaines31/makerskills
/plugin install makerskills@makerskills

第二步:指定团队 Vault 路径

知识库默认存放在 ~/Documents/CompanyBrain/,也可以在 ~/.zshenv 中按团队自定义(完整说明见 references/vault-config.md):

export COMPANY_BRAIN_VAULT="$HOME/code/mycompany-brain"

第三步:初始化目录结构

按 vault-config 中的初始化步骤,创建 people/、companies/、meetings/、sops/ 等结构化目录,把技能自带的 schema.md 拷贝为团队的 AGENTS.md(软链为 CLAUDE.md),并生成 wiki/INDEX.md,然后提交到 git 远程仓库。git 既是同步层,也是审计层。

第四步:开始捕获

用自然语言触发即可,比如:

  • capture this into the team brain → 捕获模式,自动判断内容类型并路由到正确目录
  • compile the company wiki → 编译模式,把未处理的笔记合并进 Wiki 页面,更新索引
  • what does the team know about X → 查询模式,按信任加权回答,结果存到 outputs/
  • review the company brain → 审核模式,逐条确认/降级/取代未审核内容
  • lint the company brain → 体检模式,检查过期档案、重复问题堆积、作者负载失衡等 13 项问题

官方给出的一个完整示例:把一份 Fathom 转录喂给它,捕获模式自动写入 meetings/2026-06-30-acme-discovery.md 并盖上多作者元数据;之后再执行 compile,这次会议就被合并进 <a href="https://link.gitcode.com/i/b206b58a105d67b12666c65146159aaa" target="_blank">[Acme Corp Deal]] Wiki 页面,来源标注 (added by @alex)。过程详见 [EXAMPLES.md。

四、团队协作:多人多机器如何不混乱

团队 Vault 天然是"多写者"场景,company-brain 用 git 作为协调层(完整规则见 SKILL.md 的 Multi-writer git sync 一节):

  1. 每次写入前先拉取:git pull --rebase --autostash,提交后推送;
  2. Obsidian 用户:安装 Git 社区插件,设置约 10 分钟自动拉取 + 启动时拉取,关闭自动提交,保持"一次捕获一个提交"的语义化历史;
  3. 远程 Agent 与自动同步任务:以追加为主(新文件 + 清晰提交信息 + 作者署名),不同文件追加让冲突极少发生。

🔧 小技巧:如果某个成员长期独占 80% 以上的捕获量,lint 会提示"作者负载失衡"——说明知识库依赖单个人,建议让贡献面更广。

五、可选进阶:自动同步与技能组合

团队用熟之后,可以把捕获自动化(模式与频率建议见 references/auto-sync-sources.md):

来源 捕获内容 建议频率
Fathom / Gong / Granola 通话与会议转录 每日 6:00
CRM(HubSpot / Attio / Pipedrive) 商机状态、联系人信息 每晚 1:00
Slack 导出 有价值的讨论线程 每周日
邮件转发地址 客户往来线程 实时(webhook)

📌 官方建议:先用 4–6 周手动捕获证明团队真的在用,再上自动化。过早接入会产生没人用的数据洪流。

company-brain 还能与 makerskills 的其他技能自然组合:

  • 用 loopify 定时调度同步任务与每周审核;
  • 用 toolify 接入 Fathom、CRM 等集成;
  • 用 deep-research 补齐知识库查不到的外部信息;
  • 用 decide 记录结构化决策,与 decisions/ 目录互补;
  • 用 jab-hook 基于 customer-language/ 里的客户原话产出更有共鸣的社交内容。

六、小结

company-brain 给团队的知识管理装上了 AI 就绪的"操作系统":

  • ✅ 结构化目录让多作者检索保持快速
  • ✅ 署名 + 信任分级让"垃圾进"不会变成"垃圾上下文"
  • ✅ 敏感度控制让机密内容端到端受保护
  • ✅ git 同步纪律让人与 Agent 都能安全写入
  • ✅ 与 loopify / toolify / deep-research 等技能组合,从捕获到产出形成闭环

如果你想先从个人版入手,可以了解它的姊妹技能 second-brain;更多安装与环境细节见 INSTALL.md 和 ARCHITECTURE.md。

登录后查看全文
makerskills