249 lines
7.5 KiB
Markdown
249 lines
7.5 KiB
Markdown
# Slide Task Orchestration
|
|
|
|
## Status
|
|
|
|
- Status: active workflow rule.
|
|
- Scope: local Video Workbench slide production tasks.
|
|
- First profile: `video-slide-production`.
|
|
|
|
In this workflow, `slide` is the execution unit. A slide may be a video frame unit, a PPT page, or another visual page-like unit. Current rules implement video/MV slide production only.
|
|
|
|
## Goals
|
|
|
|
- Keep the main session small enough to survive long production work.
|
|
- Keep style and character continuity anchored in `visual-system/`.
|
|
- Keep user review focused on real decisions, not every generated image.
|
|
- Keep task evidence light but sufficient for continuation after context compression.
|
|
|
|
## Worker Profiles
|
|
|
|
Current profile:
|
|
|
|
```text
|
|
video-slide-production
|
|
```
|
|
|
|
This profile uses:
|
|
|
|
- `visual-system/` as the production authority;
|
|
- `visual-system/style/style-prompt-master.md` for style modules and style prompt language;
|
|
- `visual-system/characters/character-reference-registry.md` for active character references;
|
|
- `slides/` for slide artifacts;
|
|
- `gpt-image-2` Skill Advisor / host-native prompt workflow.
|
|
|
|
Reserved future profile:
|
|
|
|
```text
|
|
ppt-page-production
|
|
```
|
|
|
|
Future PPT tasks may use `docs/cases/` as an additional case-pattern knowledge base and may need a different page brief, prompt, and review structure. Do not apply `video-slide-production` rules blindly to PPT work; design that profile when the first real PPT task needs it.
|
|
|
|
Every task plan must record:
|
|
|
|
```text
|
|
Worker Profile: video-slide-production
|
|
```
|
|
|
|
## Directory Model
|
|
|
|
Use project-local `tasks/` for orchestration records:
|
|
|
|
```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-slide-agent-packet.md
|
|
returns/
|
|
s05-v1-slide-agent-return.md
|
|
slides/
|
|
s05/
|
|
s05-v1-brief.md
|
|
s05-v1-prompt.md
|
|
s05-v1-image.png
|
|
s05-v1-review.md
|
|
```
|
|
|
|
Rules:
|
|
|
|
- `tasks/<task-id>/` records orchestration and agent communication.
|
|
- `slides/sNN/` remains the durable home for slide artifacts.
|
|
- Task records link to slide artifacts by path and should not duplicate full prompts.
|
|
- Suggested task id pattern: `YYYY-MM-DD-<short-purpose>`.
|
|
|
|
## Session Roles
|
|
|
|
### Main Session
|
|
|
|
The main session is the only session that talks with the user by default.
|
|
|
|
Responsibilities:
|
|
|
|
- receive the user instruction;
|
|
- define the worker profile, running mode, slide scope, and review expectations;
|
|
- create or update `task-plan.md`;
|
|
- split work into sequential child sessions;
|
|
- start child sessions one at a time;
|
|
- read `child-session-handoff.md`;
|
|
- ask the user only for blockers, core decisions, or requested sampling;
|
|
- update `task-log.md` with compact status.
|
|
|
|
The main session should not write per-slide briefs, final prompts, images, or routine reviews by default.
|
|
|
|
### Child Session
|
|
|
|
The child session is the small-batch context holder.
|
|
|
|
Default capacity:
|
|
|
|
- maximum 3 slides per child session;
|
|
- fewer slides for identity-heavy, repair-heavy, or context-expensive work;
|
|
- sequential only, not parallel.
|
|
|
|
Responsibilities:
|
|
|
|
- read project rules and the task plan;
|
|
- read shared project context for assigned slides;
|
|
- read active `visual-system/` files needed for assigned slides;
|
|
- write one `sNN-vN-brief.md` per assigned slide;
|
|
- create one slide-agent packet per slide;
|
|
- start exactly one slide agent per slide, sequentially;
|
|
- verify expected files were written;
|
|
- write `child-session-handoff.md`.
|
|
|
|
### Slide Agent
|
|
|
|
The slide agent is the single-slide worker.
|
|
|
|
Default capacity:
|
|
|
|
- one slide per invocation;
|
|
- no ranges;
|
|
- no batches.
|
|
|
|
Responsibilities:
|
|
|
|
- read the packet and brief;
|
|
- follow the `gpt-image-2` Skill Advisor / host-native prompt workflow;
|
|
- preserve visual-system reference choices in `sNN-vN-prompt.md`;
|
|
- write or update `sNN-vN-prompt.md`;
|
|
- generate an image only when the packet allows generation;
|
|
- write `sNN-vN-review.md` only when required;
|
|
- write a compact return file.
|
|
|
|
The slide agent must not:
|
|
|
|
- write the brief in the default workflow;
|
|
- process a second slide;
|
|
- replace style-master guidance with ad hoc style text;
|
|
- replace active character image references with text-only identity description when character continuity matters;
|
|
- use archived style or character references unless the packet explicitly reopens them;
|
|
- call Minimax MCP or external review tools by default.
|
|
|
|
## Running Modes
|
|
|
|
### Prompt And Generate
|
|
|
|
Use when the user authorizes generation for the task scope.
|
|
|
|
Flow:
|
|
|
|
```text
|
|
child session writes brief
|
|
-> slide agent writes prompt
|
|
-> if visible character identity matters, load required character reference image(s)
|
|
-> slide agent generates image
|
|
-> slide agent writes review if required
|
|
-> slide agent return
|
|
```
|
|
|
|
### Prompt Only
|
|
|
|
Use when the user wants prompt sampling, external cross-checking, or delayed generation.
|
|
|
|
Flow:
|
|
|
|
```text
|
|
child session writes brief
|
|
-> slide agent writes prompt
|
|
-> slide agent return
|
|
```
|
|
|
|
Generation can happen later through a separate task.
|
|
|
|
## Authorization Rule
|
|
|
|
The user gives the main session concrete instructions for:
|
|
|
|
- running mode;
|
|
- slide scope;
|
|
- generation permission;
|
|
- review or sampling expectations.
|
|
|
|
If the task says `prompt only`, no image generation is allowed.
|
|
|
|
If the task says `prompt and generate`, the task plan must record the authorized slide scope and exceptions. That task-level instruction is the generation approval for the named scope. Core, repair, identity-heavy, or otherwise high-risk slides may still require prompt-only handling or an explicit pause when the task plan says so.
|
|
|
|
## Visual-System Requirements
|
|
|
|
`visual-system/` is the production authority.
|
|
|
|
For every slide:
|
|
|
|
- use active visual-system files, not memory reconstruction;
|
|
- choose style from `visual-system/style/style-prompt-master.md`;
|
|
- record style module and active style references in the brief and prompt;
|
|
- choose character references from `visual-system/characters/character-reference-registry.md` when a visible character matters.
|
|
|
|
For visible character slides:
|
|
|
|
- text-only identity prompting is not sufficient;
|
|
- the brief must name the character reference image(s);
|
|
- the prompt must assign visible-context roles such as `Image 1: identity reference`;
|
|
- if the active generation path cannot load the required character image reference, the agent must block instead of generating a text-only identity-critical image.
|
|
|
|
## Document Structures
|
|
|
|
Stable templates live in:
|
|
|
|
```text
|
|
docs/workflows/slide-task-templates.md
|
|
```
|
|
|
|
Required per-slide artifacts:
|
|
|
|
```text
|
|
sNN-vN-brief.md
|
|
sNN-vN-prompt.md
|
|
sNN-vN-image.png # only when generation is allowed and succeeds
|
|
sNN-vN-review.md # only when required
|
|
```
|
|
|
|
`brief` is the universal execution card. It is written by the child session.
|
|
|
|
`prompt` is an attachment to the brief. It should be runnable or easy to copy into another platform for cross-validation.
|
|
|
|
`review` is optional by default. Create it only for core trials, identity-heavy slides, repair targets, explicit user requests, uncertain failures, or durable accepted references.
|
|
|
|
## Review Rule
|
|
|
|
Default review is local-only.
|
|
|
|
- Do not call Minimax MCP by default.
|
|
- Do not transmit private project images to external services unless the user explicitly authorizes it for that task.
|
|
- For character-visible slides, check whether the required character image reference was actually loaded.
|
|
- For style-sensitive slides, check whether the prompt used the active style module from the style master.
|
|
|
|
Routine non-core generated slides can be tracked in:
|
|
|
|
```text
|
|
tasks/<task-id>/task-log.md
|
|
slides/slides.md
|
|
```
|