knowledge-vault/discussions/creative/在路上/编排流程计划.md

601 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 镜头任务编排计划
## 状态
- 草稿日期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` 的旧批量候选图像标记为仅供对比。