save-to-brain 是营销手册系列（research-market、plan-campaign、make-content、analyze-performance）共用的“保存”原子技能。其定位是让每一个需要长期保留的产物都经过同一条保存路径，而不是只存在于聊天记录或本地磁盘中。对使用者而言，最终应被告知“已保存到你的品牌”或以平实语言说明失败原因，而不暴露工作区、文档、导入等内部概念。
用途：把调用方手册产出的成品文件保存进品牌知识，使其可被后续检索与复用；同时维护同一路径文件的合并与版本关系，避免覆盖他人或历史副本。
主要能力：
- 先读后写与合并。写入前先列出目录并读取目标文件；合并时保留每一行已有记录（id 稳定），新增行，原地更新变更行，不静默删除行，而是标注 status: retired（原因、日期）；保持文件头行最新。若写入的是其他手册的文件，只在自己的请求行下追加。
- 不覆盖他人副本。若同一路径已有本次运行未写入的 keep-history 文件（来自其他会话或当天更早运行），则给本次文件名加后缀（有 job slug 用 job slug，否则 -2、-3），标题同样处理，因为后续清理只按精确标题删除。supersede 记录则本就应被替换，保持原名。
- 登记与导入。用 media_upload 以品牌范围、文档类型、工作区来源登记文件（标题与标签），再用 knowledge_import 导入并通过 job_get 等待就绪；若任何回答出现价格，暂停并向用户确认。内联字节来源不接受文本文档，必须走工作区。
- 旧副本清理。仅在导入就绪后进行：列出品牌范围文档，只处理同时带有调用方全部标签、且首个标签（创建者）与调用方首个标签一致的记录；supersede 删除除日期与版本外标题相同的旧副本，keep-history 只删除标题完全相同的同周期重跑副本，其他周期与带后缀标题的同日副本作为历史永不删除。删除上传会同时移除其知识，工作区文件永不删除。
- 验证。用应命中新内容的查询检索（有 brand_knowledge_* 工具时用 brand_knowledge_search 并限定 source_types: [document]，否则用 knowledge_search）；若未返回或仍在索引，应说“已保存，尚不可搜索”，不得在未进入知识库时声称已进入。
使用方式：该技能由调用手册提供输入，包括 brand_id、brand_slug、coworker_agent_id（来自 brand_read 列表结果）、path（手册在 marketing-guide §4 表中的路径，日期格式 YYYY-MM-DD）、artifact（产物名，用于标题与标签）、title（<产物> — <品牌> — <日期>，带编号版本加 v<N>，带后缀文件加相同后缀）、tags（[<手册>, <产物slug>] 及区分副本的额外键，全小写，首个标签为创建者）、versioned（supersede 或 keep-history）、import（yes 默认，no 用于不应进入品牌知识的工作文件）。执行顺序为：读取合并 → file_write 写文件（import: no 则到此为止）→ media_upload 登记 → knowledge_import 导入并等待 → 清理旧副本 → 检索验证。
本地模式（无 GooseWorks，见 marketing-guide §5）：不调用 gooseworks: 工具，也不需要 brand_id 与 coworker_agent_id。宿主有文件工具时，读取 gooseworks-local/<brand-slug>/<path>（若存在），按步骤 1 规则合并（含不覆盖），写入后回读，跳过步骤 2–6，并说“已保存到此文件夹”而非“已保存到你的品牌”。无文件的托管聊天则无法保存：在聊天中按路径给出完整文件，并说明“这没有保存在任何地方，下次请粘贴回来，我会从中继续”。
工作区范围：每次文件调用与上传的工作区来源都使用 marketing-guide §2 的范围；若无 coworker，需告知用户一次：“此品牌尚无 coworker，因此我以它的名义保存在你的通用工作区中。”
状态与索引：导入的文档只算“可找到”，不能称为已确认，也不是已批准的声明（见 marketing-guide §1.4）。brand_knowledge_search 可能回答“仍在索引：M 中的 N”，这表示“已保存、尚不可搜索”，不是失败，不得重复导入。
适用场景：营销调研、活动策划、内容制作、效果分析等手册产出需要沉淀到品牌知识库时；需要按日期维护历史版本或按最新版本替换档案时；需要区分可入库成品与不入库的中间工作文件时。
限制：依赖 gooseworks 系列工具（file_list、file_read、file_write、media_upload、knowledge_import、job_get、media_list、media_update、knowledge_search 或 brand_knowledge_*）；工具缺失时应调用一次 tools_load（组：files、media、brand），仍失败则把产物在聊天中交给用户、明确说明未保存到其品牌，并在本次交接中记录失败。内联字节来源不能直接接收文本文档。删除上传会连带移除其知识。具体价格、平台覆盖范围等资料未提供。