601 lines
14 KiB
Markdown
601 lines
14 KiB
Markdown
# 镜头任务编排计划
|
||
|
||
## 状态
|
||
|
||
- 草稿日期: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/<project-id>/
|
||
tasks/
|
||
<task-id>/
|
||
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/<task-id>/` 用于记录编排与代理通信。
|
||
- `slides/sNN/` 仍是镜头产出的长期存档位置。
|
||
- 任务文件不应全文复制提示词,除非状态跟踪或调试确实需要。
|
||
- 任务记录应通过路径引用镜头产出。
|
||
|
||
建议的任务编号模式:
|
||
|
||
```text
|
||
YYYY-MM-DD-<short-purpose>
|
||
```
|
||
|
||
示例:
|
||
|
||
```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-id>/task-log.md
|
||
slides/slides.md
|
||
```
|
||
|
||
## 任务文件结构
|
||
|
||
### `task-plan.md`
|
||
|
||
```text
|
||
# <Task Title>
|
||
|
||
## 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` 的旧批量候选图像标记为仅供对比。 |