# 镜头任务编排计划 ## 状态 - 草稿日期：2026-06-24。 - 范围：本地视频工作台镜头生产编排。 - 状态：待用户审阅的草稿。 - 项目驱动文件：`projects/2026-06-23-在路上`。 本计划并非 CCPE 工作流，而是一份本地视频工作台执行规约，旨在保持镜头生产可追溯、轻量化的同时，降低主会话的上下文压力。 ## 核心原则 1. 保持工作流务实。 - 这不是软件开发项目，不应演变为沉重的治理体系。 - 仅记录续接、调试和用户审阅所必需的最小任务证据。 2. 保护用户注意力。 - 用户和任何专家评审人都不应逐个检查非核心镜头。 - 用户审阅保留用于运行授权、核心镜头、高风险镜头、失败镜头以及显式抽样。 3. 限定上下文范围。 - 主会话不应携带每个镜头的完整提示词、生成与评审上下文。 - 子会话为少量镜头复用通用项目上下文。 - 一个镜头代理严格对应一个镜头。 4. 避免会话污染。 - 默认不设并行子会话。 - 不设多镜头代理。 - 批量分组在会话层面完成，不在镜头代理内部进行。 5. 以文件作为续接依据。 - 聊天记录在压缩后不再具有权威性。 - 简报、提示词、图像、回报、日志与交接必须落盘。 ## 编排模型 ```text 主编排会话 -> 任务计划 -> 子会话 01 -> 为 s05 撰写简报 -> 启动 s05 的镜头代理 -> 为 s21 撰写简报 -> 启动 s21 的镜头代理 -> 为 s14 撰写简报 -> 启动 s14 的镜头代理 -> 撰写子会话交接 -> 子会话 02 -> 为 s25 撰写简报 -> 启动 s25 的镜头代理 -> 为 s33 撰写简报 -> 启动 s33 的镜头代理 -> 撰写子会话交接 ``` 默认子会话容量： - 每个子会话最多 3 个镜头。 - 当镜头属于高身份负担、高修复负担或上下文成本较高时，可酌情减少。 - 子会话按顺序串行运行，不并行。 默认镜头代理容量： - 每次调用仅处理 1 个镜头。 - 镜头代理不得接收镜头范围或批量镜头。 ## 目录模型 本地编排记录使用 `tasks/`，不使用 `runs/`。 ```text projects// tasks/ / task-plan.md task-log.md session-01/ child-session-plan.md child-session-handoff.md packets/ s05-v1-shot-agent-packet.md returns/ s05-v1-shot-agent-return.md session-02/ child-session-plan.md child-session-handoff.md packets/ returns/ slides/ s05/ s05-v1-brief.md s05-v1-prompt.md s05-v1-image.png s05-v1-review.md ``` 规则： - `tasks//` 用于记录编排与代理通信。 - `slides/sNN/` 仍是镜头产出的长期存档位置。 - 任务文件不应全文复制提示词，除非状态跟踪或调试确实需要。 - 任务记录应通过路径引用镜头产出。 建议的任务编号模式： ```text YYYY-MM-DD- ``` 示例： ```text projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/ ``` ## 主会话职责 主会话默认是与用户对话的唯一会话。 主会话应： - 接收用户指令； - 定义任务范围与允许的运行模式； - 决定子会话拆分方案； - 创建或更新 `task-plan.md`； - 按顺序启动子会话； - 读取每份 `child-session-handoff.md`； - 仅在出现真实决策、阻塞或用户主动要求抽样时向用户询问； - 以紧凑状态更新 `task-log.md`。 主会话不应： - 默认撰写单镜头简报； - 默认撰写最终提示词； - 默认生成图像； - 默认审阅每个非核心图像； - 在聊天中携带所有镜头的上下文。 ## 子会话职责 子会话是小批量上下文的持有者。 子会话应： - 读取项目规则与任务计划； - 读取分配镜头所需的共享项目上下文； - 为每个分配镜头撰写一份 `sNN-vN-brief.md`； - 为每个镜头创建一份镜头代理任务包； - 为每个镜头按顺序启动恰好一个镜头代理； - 核验预期文件是否已落盘； - 结束前撰写 `child-session-handoff.md`。 子会话不应： - 除非主会话明确指示，否则与用户对话； - 默认处理超过 3 个镜头； - 并行运行镜头代理； - 除非镜头代理路径不可用，否则自行生成最终提示词； - 将任务记录变成完整的审计包。 ## 镜头代理职责 镜头代理是单镜头执行者。 镜头代理应： - 读取所提供的任务包； - 读取镜头简报； - 撰写或更新 `sNN-vN-prompt.md`； - 仅在任务包允许生成时生成图像； - 仅在需要时撰写 `sNN-vN-review.md`； - 撰写一份简短的回报文件。 镜头代理不应： - 在默认工作流中撰写简报； - 处理第二个镜头； - 推断任务包之外的任务范围； - 除非任务包明确重新启用，否则使用已归档的角色或风格参考； - 默认调用 Minimax MCP 或外部评审工具。 ## 镜头代理运行模式 主会话为每个任务选择运行模式。 ### 模式 1：提示词与生成 在用户授权任务范围内生成时使用。 流程： ```text 子会话撰写简报 -> 镜头代理撰写提示词 -> 镜头代理生成图像 -> 镜头代理按需撰写评审 -> 镜头代理回报 ``` 适用场景： - 任务级授权后的非核心生产； - 低风险环境镜头； - 提示词模式已趋稳定的续接工作。 ### 模式 2：仅提示词 在用户希望进行提示词抽样、外部交叉核验或延后生成时使用。 流程： ```text 子会话撰写简报 -> 镜头代理撰写提示词 -> 镜头代理回报 ``` 生成可稍后通过单独任务执行。 适用场景： - 高风险身份镜头； - 新项目首轮验证； - 在 ChatGPT 或其他平台进行提示词抽样； - 任何用户希望在生成前审阅提示词的任务。 ## 任务授权规则 用户向主会话下达具体指令，覆盖： - 代理运行模式； - 镜头范围； - 生成权限； - 评审/抽样要求。 若任务标注为 `prompt only`，则禁止图像生成。 若任务标注为 `prompt and generate`，则任务计划必须记录授权的镜头范围及例外条款。 核心、修复、高身份负担或其他高风险镜头，若任务计划有规定，仍可能需要按仅提示词方式处理或显式暂停。 ## 简报结构 简报是通用的镜头执行单，无论 GPT 是否提供了专用的单镜头骨架，其结构均保持一致。 推荐结构： ```text # S-NN Shot Brief V1 ## Status ## Source Basis ## Shot Function ## First Read ## Risk Class ## Reference Plan ## Visual Requirements ## Character Handling ## Composition / Scale ## Light / Color / Texture ## Forbidden Drift ## Acceptance Checklist ## Prompt Handoff ``` ### 简报字段规则 `Status` 记录文档状态、任务编号、镜头编号、版本及当前执行状态。 `Source Basis` 仅列出本简报使用的关键来源，不要将其变成完整的审阅清单。 `Shot Function` 声明该镜头在序列中的功能定位。 `First Read` 声明观众应首先注意到的内容。 `Risk Class` 对镜头分类，例如： ```text environment-only object/body detail distant human medium human close/face human core motif repair ``` `Reference Plan` 命名必需的风格模块与角色参考，或说明为 `none` 并给出理由。 `Visual Requirements` 列出内容上的正向要求。 `Character Handling` 记录可见性、身份负担、比例、姿态与道具连续性。 `Composition / Scale` 记录画面逻辑、人物大小、第一眼层级与位置安排。 `Light / Color / Texture` 记录局部光照与材质规则。 `Forbidden Drift` 记录主要的失败模式。 `Acceptance Checklist` 是最低本地核验清单。 `Prompt Handoff` 告知镜头代理：提示词在生成环节必须承载的内容。 ## 提示词结构 提示词文件作为简报的附件存在，应可直接运行，或便于跨平台进行提示词核验。 推荐结构： ```text # S-NN Shot Prompt V1 ## Status ## Based On Brief ## Reference Inputs ## Operation Notes ## Final Prompt ## Negative / Avoid ## Output Intent ``` ### 提示词字段规则 `Status` 记录镜头编号、版本、模式及执行状态。 `Based On Brief` 链接到简报路径。 `Reference Inputs` 列出实际使用的图像参考及其角色。 在使用支持参考能力的宿主生成时，应使用明确的可见上下文角色： ```text Image 1: identity reference Image 2: style reference ``` `Operation Notes` 仅记录与生成相关的操作步骤，例如在调用宿主图像工具前加载参考图。 `Final Prompt` 应可复制到其他图像生成平台，仅需最少的清理工作。 `Negative / Avoid` 应可作为负向提示词或避免清单直接复制。 `Output Intent` 记录预期的项目输出路径及相关的交叉核验说明（如有）。 除运行必需外，下列内容不应出现在常规提示词文件中： - 完整的项目说明； - 长篇源文件审计； - 详细的 Skill 文件叙述； - 评审结论； - 任务编排历史。 ## 评审结构 评审默认是可选的。 仅在以下情形创建 `sNN-vN-review.md`： - 镜头为核心试验镜头； - 镜头为高身份负担镜头； - 镜头为修复目标； - 用户明确要求评审记录； - 代理检测到可能的失败或不确定性； - 图像被采纳为长期参考。 推荐结构： ```text # S-NN Shot Review V1 ## Status ## Generation Trace ## Local File Check ## Local Visual Check ## Acceptance Checklist ## Issues ## Decision / Next Action ``` 默认评审规则： - 仅使用本地能力。 - 默认不调用 Minimax MCP。 - 除非用户在该任务中明确授权，否则不将项目私密图像传输到外部服务。 非核心生成镜头可改为记录在以下位置： ```text tasks//task-log.md slides/slides.md ``` ## 任务文件结构 ### `task-plan.md` ```text # ## Status ## User Instruction ## Running Mode ## Shot Scope ## Child Session Split ## Shared Context ## Rules ## Expected Outputs ## User Review / Sampling Plan ## Stop Conditions ``` ### `child-session-plan.md` ```text # Child Session NN Plan ## Status ## Parent Task ## Assigned Shots ## Shared Context To Read ## Per-Shot Work Order ## Agent Packet Paths ## Stop Conditions ``` ### `shot-agent-packet.md` ```text # S-NN Shot Agent Packet V1 ## Status ## Target Shot ## Allowed Actions ## Input Files ## Output Files ## Reference Roles ## Generation Rule ## Review Rule ## Return File ``` ### `shot-agent-return.md` ```text # S-NN Shot Agent Return V1 ## Status ## Files Written ## Generation Result ## Review Result ## Blockers ## Next Action ``` ### `child-session-handoff.md` ```text # Child Session NN Handoff ## Status ## Completed Shots ## Files Written ## Problems / Repairs Needed ## User Decisions Needed ## Next Session Input ``` ### `task-log.md` 保持紧凑，不作为完整审计记录。 ```text # Task Log ## Status ## Timeline ## Child Session Results ## Shot Status Summary ## Open Decisions ``` ## 计划中的文件与文件夹变更 本计划应在用户审阅通过后实施。 ### 新增文档 ```text docs/workflows/shot-task-orchestration.md docs/workflows/shot-brief-structure.md docs/workflows/shot-prompt-structure.md docs/workflows/shot-review-structure.md docs/workflows/shot-agent-packet.md ``` 可能的合并方案： - 若文件过多，可合并为一份稳定的工作流文档与一份模板文档。 ### 新增模板 ```text docs/templates/task-plan-template.md docs/templates/child-session-plan-template.md docs/templates/child-session-handoff-template.md docs/templates/shot-agent-packet-template.md docs/templates/shot-agent-return-template.md docs/templates/shot-brief-template.md docs/templates/shot-prompt-template.md docs/templates/shot-review-template.md ``` ### 更新工作区规则 ```text VIDEO_WORKBENCH.md AGENTS.md ``` 预期更新内容： - 新增 `tasks/` 作为本地任务编排目录； - 定义主会话 / 子会话 / 镜头代理的边界； - 定义两种镜头代理运行模式； - 声明任务级用户指令控制生成授权； - 声明评审默认仅限本地，且不调用 Minimax MCP。 ### 首次试验期间新增项目任务目录 针对 `在路上` 角色一致性试验： ```text projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/ ``` 预期子结构： ```text task-plan.md task-log.md session-01/ session-02/ ``` ### 首次试验期间现有镜头产出的变更 可能生成或更新的文件： ```text projects/2026-06-23-在路上/slides/s05/s05-v1-brief.md projects/2026-06-23-在路上/slides/s05/s05-v1-prompt.md projects/2026-06-23-在路上/slides/s21/s21-v1-brief.md projects/2026-06-23-在路上/slides/s21/s21-v1-prompt.md projects/2026-06-23-在路上/slides/s14/s14-v1-brief.md projects/2026-06-23-在路上/slides/s14/s14-v1-prompt.md projects/2026-06-23-在路上/slides/s25/s25-v1-brief.md projects/2026-06-23-在路上/slides/s25/s25-v1-prompt.md projects/2026-06-23-在路上/slides/s33/s33-v1-brief.md projects/2026-06-23-在路上/slides/s33/s33-v1-prompt.md ``` 图像与评审文件视任务运行模式而定。 ## 首次试验建议 以角色一致性镜头作为首次编排试验。 任务： ```text projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/ ``` 子会话拆分： ```text session-01: s05 -> s21 -> s14 session-02: s25 -> s33 ``` 建议的首次运行模式： ```text prompt only ``` 理由： - 可以在不消耗图像生成上下文的前提下，验证新的简报与提示词结构。 - 用户可根据需要在外部分别抽样核验提示词。 - 后续任务可使用同一套提示词进行生成。 若用户选择 `prompt and generate`，则任务计划必须记录该指令及精确的镜头范围。 ## 待决实施事项 1. 是将稳定文档拆分为五份文件，还是合并为一份工作流文档加模板集。 2. 是否立即更新 `AGENTS.md`，还是先仅更新 `VIDEO_WORKBENCH.md` 以支持本本地工作流。 3. 首次试验应采用 `prompt only` 还是 `prompt and generate`。 4. 在角色一致性任务启动前，是否应将 `s05`、`s14`、`s21`、`s25`、`s33` 的旧批量候选图像标记为仅供对比。