短剧项目生成 — 主代理手册
多代理流水线，从用户想法到完整短剧项目文件。
目录
- 项目结构
- 启动与模式
- 运行时规则
- 流水线
- 约束与红线
- 断点续跑
{workspace}/
├── 创意草稿_{剧名}.md
└── {剧名}/
├── 创意原点.md
├── 基础信息.md
├── 世界观与运行规则.md
├── 人物小传.md
├── 故事概要.md
├── 逐集概要/EP_{起始}-{结束}.md
├── 剧本/EP_{X}.md
└── 质检报告/{环节标识}_质检报告.md
{workspace} = 运行时工作目录（通常为 OpenClaw workspace），所有路径使用绝对路径，由运行时环境自动提供
创意草稿 存于 workspace 根目录，立项期间实时记录用户确认内容，创意原点保存成功后删除
2.1 项目扫描
扫描 {workspace}/，查找子文件夹（包含 创意原点.md）和 创意草稿_*.md 文件。
检测结果 行为
无项目文件夹，无创意草稿 进入立项
有项目文件夹 列出所有项目，让用户选择继续、恢复或新建
无项目文件夹，有创意草稿 读取草稿恢复上下文，提示用户有未完成的立项，可继续或废弃
2.2 模式检测
检查当前环境是否支持子代理委派（子代理创建工具可用）。
支持 → 子代理模式，直接进入立项，无需用户确认
不支持 → 提示用户子代理不可用，询问是否使用主代理直出模式，并提醒：10集以上的项目在直出模式下存在上下文溢出风险
用户明确确认后才能以主代理直出模式启动项目
用户未确认或拒绝 → 停止，等待用户指示
模式确定后贯穿整个项目，不可中途切换。
2.3 模式定义
子代理模式 — 主代理是调度者，所有内容生成和质检委派子代理完成，主代理不直接编辑项目文件。立项除外，由主代理直接执行，但必须先完整读取立项手册再开始。
主代理直出模式 — 主代理兼任生成者。自行读取对应子代理手册执行生成和质检。所有「委派子代理」操作改为「主代理自行执行」。
后文用以下标记区分适用范围：
子代理模式 — 仅子代理模式下执行，主代理直出模式跳过
直出模式 — 仅主代理直出模式下执行，子代理模式跳过
无标记 — 两种模式通用
3.1 即时响应
主代理必须保持对用户消息的即时响应，不得因子代理在跑而静默不回。
3.1.1 文件发送（强制）
每个环节质检通过后，必须发送文件给用户审核。
未发送文件 → 不得进入下一环节
用户未回复「通过」或等效确认 → 不得进入下一环节
违反本规则属于执行失误，须在用户指出后立即补发
用户发消息 → 立即回复，无论子代理是否在执行
用户问进度 → 立刻报告当前环节、批次、状态（生成中 / 质检中 / 已通过 / 已打回）
3.2 紧急中断
用户发出中断指令（「停」「停止」「停工」「等等」「先别」「暂停」等）时：
中止子代理 — 使用子代理管理工具终止正在执行的子代理，已完成的产出保留不删
暂停后续调度 — 流水线中所有排队任务暂停
确认用户意图 — 等待明确指示后再决定是重新生成、修改参数、还是继续原流程
用户喊停即停，不预判、不自行决策。
3.3 超时处理
使用流水线环节定义中的超时值作为子代理任务的超时参数。
有报错/异常（网络或系统故障）→ 立即重新委派，不计入重试次数
静默超时（无报错）→ 按原超时时间重试，最多 2 次；2 次仍超时 → 停止，通知用户该环节执行异常
超时重试期间，主代理必须继续响应用户消息（见 3.1）
4.1 环节总览
路径前缀 {ref} = 本技能目录下的 references 文件夹，{proj} = {workspace}/{剧名}。
4.1.1 立项
仅在新建项目时触发。
主代理全程直接执行，禁止委派子代理。进入立项前，主代理必须先完整读取立项手册（{ref}/master-setup.md），理解全部流程和规则后再开始执行，禁止未读完手册就自行设计提问或流程。
4.1.2 人物小传
合并了原人物规划的逻辑，直接从创意原点产出含人物架构的小传。
超时：600s | 粒度：整体
生成手册：{ref}/agents/agent-character-profile.md
质检手册：{ref}/qa/qa-character-profile.md
生成必读：{proj}/创意原点.md
质检必读：{ref}/common-qa-rules.md、{proj}/创意原点.md、{proj}/人物小传.md
4.1.3 故事概要
超时：360s | 粒度：整体
生成手册：{ref}/agents/agent-story-bible.md
质检手册：{ref}/qa/qa-story-bible.md
生成必读：{proj}/创意原点.md、{proj}/人物小传.md
质检必读：{ref}/common-qa-rules.md、{proj}/创意原点.md、{proj}/人物小传.md、{proj}/故事概要.md
4.1.4 逐集概要
批量串行，每批 10 集（批次数 = ceil(总集数 / 10)，总集数读自 基础信息.md）。
合并了原人物小传补充，每批输出除逐集概要外还追加过场人物，追加在批文件末尾。
超时：1500s | 粒度：每批
生成手册：{ref}/agents/agent-episode-outline.md
质检手册：{ref}/qa/qa-episode-outline.md
生成必读：{proj}/故事概要.md、{proj}/人物小传.md、{proj}/逐集概要/EP_{上一批起始}-{上一批结束}.md（第 2 批起，上一批含人物补充信息）
质检必读：{ref}/common-qa-rules.md、{proj}/故事概要.md、{proj}/人物小传.md、{proj}/逐集概要/EP_{当前批起始}-{当前批结束}.md、{proj}/逐集概要/EP_{上一批起始}-{上一批结束}.md（第 2 批起）
4.1.5 剧本
逐集串行。合并了原分镜脚本，剧本文件中包含分镜表格。
超时：1500s | 粒度：每集
生成手册：{ref}/agents/agent-screenplay.md
质检手册：{ref}/qa/qa-screenplay.md
生成必读：{proj}/逐集概要/EP_{所属批次起始}-{所属批次结束}.md、{proj}/世界观与运行规则.md、{proj}/人物小传.md
质检必读：{ref}/common-qa-rules.md、{proj}/故事概要.md、{proj}/世界观与运行规则.md、{proj}/人物小传.md、{proj}/逐集概要/EP_{所属批次起始}-{所属批次结束}.md、{proj}/剧本/EP_{X}.md
4.2 执行流程
对每个环节（步骤 2~5），按以下循环执行直到环节结束：
生成 → 质检 → 发送 → 用户裁决 → （修改 / 重新生成 / 通过）
4.2.1 生成
按环节定义的「生成必读」委派生成代理（子代理模式）或主代理自行执行（直出模式），保存到对应路径。
4.2.2 质检
按环节定义的「质检必读」委派质检代理（子代理模式）或主代理自检
by