用途
bmad-ingest 把一个原始输入（转录稿、聊天或邮件线程、语音备忘、长文档）转成一份笔记，让人或智能体读这份笔记而不是读原文。因为读者会直接依据笔记行事、不再核对原文，所以每一项都必须能追溯到原文中的具体位置，且不得出现原文没有说过的内容。原始输入按到达时的样子保留，便于任何人核查。
主要能力
- 保留原始素材：原始文件存入工作流指定的 raw 目录，按输入发生的时间命名（格式 YYYY-MM-DD-<slug>），重名时追加 -2、-3 等。项目外的原件会复制进来；带附件的原件以文件夹形式保存原件与附件；已在项目内的原件保持原位；URL 会记录，若抓取过内容也会保存所读内容。
- 选择模板：可指定模板路径或 URL，也可从模板库中按描述挑选并说明理由；没有合适的时，对话类默认用会议模板，其它默认用文档模板。模板中的注释用于引导，不进入笔记；“done when” 作为审校标准。
- 撰写笔记：确定笔记存放位置，每份原始输入生成一份笔记（除非要求合并）。笔记含标题、描述、模板、采集日期、来源等前置信息；每项内容指向原文中的时间戳、章节、消息日期与发言人或短引文。
- 事实约束：负责人、日期、数字和条件只按原文表述呈现；相对日期在原文日期已知时补充具体日历日期，日期与星期需通过 date 或 cal 获取而非凭记忆；人名按原文称呼；被推翻或更正的内容给出最终状态并说明变化；措辞关键处（承诺、客户原话）精确引用。
- 处理不确定项：原文本身未定之处（听不清的段落、发言人不明、两种说法冲突）放入最后的“## Unclear in the source”章节，没有则省略。
- 长文本处理：过长原文分段阅读并持续记录笔记，写前先厘清跨段变化（如上午决定下午被推翻）。
- 审校：由未参与写作的读者（子代理或自身二次通读）对照原文检查遗漏或误述的决定、承诺、条件，把提议当成已决定、引用归属错误、引用不支持内容、模板要求未满足等问题；核对后再修改。
- 无头模式：调用方要求或无人时静默运行，结束时输出包含 note、raw、template 和 unclear 计数的 JSON 对象。
使用方式
激活时先解析配置获取输出目录；若脚本缺失说明 BMad 未配置，需先安装 bmad 技能再重试。随后解析自定义配置，执行激活前置步骤、将持久事实视为本次运行事实、执行激活后置步骤。模板可通过项目级 _bmad/custom/ingest-templates/ 或用户级 ~/.bmad/ingest-templates/ 添加或替换，使用 frontmatter 中的 template、category、description 字段，复用 id 可替换内置模板，extends: <id> 可扩展。若要修改原始素材或笔记位置、增加模板库，可调用 bmad-customize 技能并指定 workflow.raw_folder、workflow.notes_folder 或 workflow.template_libraries。
适用场景
适合需要把会议记录、访谈转录、邮件往来、语音备忘或长篇资料转化为可执行、可核查笔记的场合，尤其适用于多智能体协作中下游智能体需直接依据笔记行动的流程。
限制
必须依赖 BMad 环境与相关脚本，脚本缺失时需先安装或更新。未提供具体模板数量、性能指标、收费信息或支持的宿主平台范围，暂未提供。