用途：brain-save 是“受治理第二大脑”中的写入侧技能，与读取侧 /brain 配套。它把一条持久事实、决策、模式或约定写入大脑，或淘汰已不再正确的记忆，避免为新增一条内容而重新编译整个语料。它不会从对话中自动触发，只有显式输入才会执行。
主要能力：捕获候选条目（brain_capture），随后运行确定性的治理步骤（brain_govern）：去重、策略校验、密文检测、提升入库，并为该决定写入 SHA-256 哈希链审计事件。治理在代码中完成，技能只是提议条目，由确定性策展器决定是否以及如何落库。支持的状态迁移包括 active → deprecated / superseded / archived，deprecated → active / archived，superseded → archived。
必要用法：保存新事实时，先搜索（search-before-save）。调用 brain_search 传入 { query: "TITLE_AND_KEY_TERMS", scope: "all" }，根据 qmd:// 命中结果总结大脑已知内容；若已覆盖则停止以避免重复。仅捕获真正新增的增量，判断标准如“30 天后我还会想找到它吗”，跳过临时调试步骤、一次性偏好、密钥，以及已写在 CLAUDE.md/README 中的内容。选择类别：decision、pattern、convention、architecture、troubleshooting、onboarding 或 reference。然后调用 brain_capture。本地模式下再调用 brain_govern 排空缓冲，并报告 promoted、quarantined、rejected、duplicate、flagged、skipped 计数。团队模式不调用 brain_govern，只报告 brain_capture 的结果。淘汰记忆时，先用 /brain 找到记忆并从引用文件名 qmd://COLLECTION/UUID.md 提取 UUID，再调用 brain_transition。
适用场景：本地模式（默认，未设置 TEAMKB_API_URL）所有工具在进程内运行，你完全拥有大脑。团队模式（设置 TEAMKB_API_URL）大脑由服务器集中治理，成员提议、管理员治理与淘汰，成员调用 brain_transition 会收到 403。可用 brain_status 做连接健康检查。本地模式可用 brain_audit_verify 校验审计链。
限制：本地模式下 qmd 2.x 需在 PATH 中，以便提升后刷新搜索索引；qmd 缺失时捕获、治理与审计回执仍完成，仅新记忆暂不出现在搜索中。团队客户端不需要本地 qmd，也不暴露 brain_govern 和 brain_audit_verify。来源令牌证明捕获来自何处，不证明其内容为真。切勿保存含密钥、令牌或凭据的内容。淘汰的 reason 必须为真实、可读的理由并进入永久审计轨迹。治理拒绝是系统按设计工作，不是需要绕过的缺陷。