mc-outline 是 bmad-code-org/bmad-manticore 中的大纲阶段技能,对应 Gate 1。其目标是产出一份 outline.md:三个钩子、一条大纲和包装承诺,以创作者可批准、编辑或否决的形式呈现,而且这一切发生在写出任何脚本台词之前。它是决策产物,不是脚本草稿。其中所有内容都必须可追溯到 braindump.md,因为脚本阶段只能使用 braindump.md 中已经说过的措辞。
用途与产出结构:三个钩子各自按 Target-Transformation-Stakes 构建,即面向谁、他们将能够做什么、为什么现在重要;在措辞合适处采用创作者 braindump 中的表达,并标注每个钩子依赖的 braindump 行。大纲只有一条而非多个选项,是从钩子到回报的紧凑节拍列表;每个节拍都引用填充它的 braindump 段落,没有素材支撑的节拍标记为 GAP 并附上要向创作者提出的问题;顺序按留存设计,开头不设清嗓子式节拍,开放环较晚闭合。braindump 中提到观众应看到的内容时,会为该节拍附上视觉时刻说明,引用对应段落并标注为非约束性,供 mc-beats 作为候选构图而非承诺。包装承诺部分给出本条视频必须兑现的工作标题与缩略图概念,以及一行 CTA 计划,取自 studio 配置中的 [cta],说明本条视频将制作哪些已配置的 CTA、大致位置,并按配置的规模与数量安排;若未配置 CTA,该行会明确说明。若视频无法兑现可点击的承诺,会在此时指出,并说明这是项目问题而非包装问题。
使用方式与前置条件:激活时先解析 studio 配置(uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.manticore),若为空则说明 mc-setup 尚未运行,停止并引导创作者前往。随后读取 project.json 确认 stage 为 outline,再读取 braindump.md 与格式配置。接着读取 {brand-path}/voice-bible.md,若不存在则告知缺失并说明没有它无法用创作者的声音做钩子,引导至 mc-setup 后停止;其 hook 部分约束候选钩子。再读取 {brand-path}/blacklist.md,若不存在则告知缺失并说明没有它无法在 Gate 1 前做黑名单检查,引导至 mc-setup 后停止。呈现之前运行 uv run {skill-root}/scripts/lint_script.py {projects-path}/<slug>/outline.md --blacklist {brand-path}/blacklist.md,退出码 1 会列出黑名单违规,须逐项修复。路径规则:裸路径相对 {video-path}(即 {projects-path}/<slug>/ 下的当前视频项目)解析;{skill-root} 指本技能安装目录;{project-root} 指项目工作目录。
Gate 1 与批准流程:将全部内容写入 outline.md,设置 approvals.outline = "pending",更新 artifacts,呈现给创作者并停止;不得开始写脚本,不得描述脚本将说什么。只有创作者明确同意才能推进此门。批准后,在 approvals.outline 记录 ISO 日期,将 outline 追加到 stages_done,并将 stage 设为 project.json 中 stages 数组的下一个条目。
适用场景:处于大纲阶段时,或用户说“outline this”“write the outline”“what is the hook”时使用。限制:依赖已运行的 mc-setup 配置、voice-bible.md 与 blacklist.md,缺失即停止并引导;产出严格可追溯到 braindump.md;不生成脚本、不描述脚本内容。