用途
mc-script 是 bmad-manticore 工作流中的脚本阶段技能,定位为“反 LLM 废话”环节。它不负责从零写作,而是在 gate 1 通过后,把已有的 outline.md 和 braindump.md 编织成由创作者本人对着镜头口播的 script.md。
主要能力
- 编织而非写作:逐节拍处理,优先直接沿用创作者 braindump 中的措辞,仅为口语流畅度做平滑。
- 引文或标记契约:每句话要么可追溯到 braindump 段落,要么带内联 [INVENTED] 标记;标记只用于连接性内容,需要虚构内容主张时视为 braindump 缺口,应询问创作者;若约超过四分之一句子需标记,则退回 mc-braindump。
- 钩子最后写:先让正文证明钩子能承诺什么,再从已批准候选中写钩子。
- 不添加舞台指示:除非创作者要求,否则不写镜头备注或“(pause)”之类表演提示。
- CTA 编织:从 studio 配置的 [cta] 中取 kind、label、url 编织 CTA 行,遵循 outline 的 CTA 计划与 craft 清单的降低门槛规则;这是引文或标记契约的唯一例外;[cta] 为空则不编造请求。
- 已上镜台词标记:若 project.json 的 sources 含采访录音,未转写则用 mc-cut 的 transcribe.py 转写,并依据词级时间戳为已口述好的台词加 [TAKE <source-id> <start>s-<end>s] 标记,这些行可能只需剪辑阶段重组而非重录。
使用方式
激活时先解析 studio 配置:uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.manticore。结果为空表示 mc-setup 未运行,应停止并引导创作者前往。随后读取 project.json 确认 gate 1 已通过(approvals.outline 为日期、stage 为 script)、outline.md、braindump.md 与格式配置。
还需读取 {brand-path}/voice-bible.md、{brand-path}/exemplars/(取 1 至 2 个文件)、{brand-path}/blacklist.md、{brand-path}/craft-checklist.md;任一缺失都说明无法按创作者声音写作、无法对照其已验证脚本编织、无法做交接前黑名单检查或无法做呈现前 craft 检查,应提示缺失并路由至 mc-setup 后停止。
路径解析规则:裸路径相对于 {video-path}(当前视频项目 {projects-path}/<slug>/);{skill-root} 指本技能安装目录;{project-root} 为项目工作目录,studio 配置中的 paths 值相对于它解析。
交付前 QA
运行 uv run {skill-root}/scripts/lint_script.py {projects-path}/<slug>/script.md --blacklist {brand-path}/blacklist.md;退出码 1 会列出违规项,需逐项修复。再执行创作者的 craft-checklist.md 及其 blacklist 底部的人工 QA 清单。最后按创作者实测 wpm([owner] wpm)和真实字数计算时长,若偏离格式目标长度需说明并标记。
交接
写入 script.md 并保留可见的 [INVENTED] 标记,更新 project.json(把 script 追加到 stages_done,并将 stage 设为 stages 数组中的下一项)后呈现。之后由创作者录制,将素材以恒定帧率放入 raw/。存在 [TAKE ...] 标记时,需明确列出差异:哪些台词已在采访录音中捕获,哪些仍需录制。
限制
本资料未提供收费、价格、平台支持范围或效果保证等信息,暂未提供。该技能依赖 mc-setup 生成的品牌文件与 studio 配置,缺失时将无法继续。