完成流程编排
This commit is contained in:
parent
45ac41f754
commit
847e5ca2c1
26
AGENTS.md
26
AGENTS.md
|
|
@ -62,4 +62,28 @@ For every project-bound image prompt document:
|
||||||
- When a local image outside the workspace is used, label its role explicitly as identity reference, edit target, or supporting reference, and do not proceed if the file cannot be read or approved.
|
- When a local image outside the workspace is used, label its role explicitly as identity reference, edit target, or supporting reference, and do not proceed if the file cannot be read or approved.
|
||||||
- For near / identity-heavy shots, prefer a relevant crop reference. For distant / landscape-led shots, prefer the accepted anchor board or project-approved distant reference. Do not repeatedly re-ask whether references can work; the verified route is Skill Advisor prompt plus loaded reference image plus host `image_gen`.
|
- For near / identity-heavy shots, prefer a relevant crop reference. For distant / landscape-led shots, prefer the accepted anchor board or project-approved distant reference. Do not repeatedly re-ask whether references can work; the verified route is Skill Advisor prompt plus loaded reference image plus host `image_gen`.
|
||||||
|
|
||||||
Project-bound image generation must remain approval-gated: save the prompt/spec first, wait for user approval, then execute generation only when explicitly requested.
|
Project-bound image generation must remain approval-gated: save the prompt/spec first, wait for user approval, then execute generation only when explicitly requested. A task-level user instruction that records the running mode and slide scope counts as explicit generation approval for that task scope. If the task mode is `prompt only`, do not generate images.
|
||||||
|
|
||||||
|
## Slide Task Workflow
|
||||||
|
|
||||||
|
For long slide / video production work, use the local slide task orchestration workflow:
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/workflows/slide-task-orchestration.md
|
||||||
|
docs/workflows/slide-task-templates.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Rules:
|
||||||
|
|
||||||
|
- Use `projects/<project>/tasks/<task-id>/` for local orchestration records.
|
||||||
|
- The main session talks with the user and defines worker profile, running mode, slide scope, and review expectations.
|
||||||
|
- Child sessions write per-slide briefs and may handle at most 3 slides by default.
|
||||||
|
- A slide agent handles exactly 1 slide per invocation.
|
||||||
|
- The default worker profile for current MV / video work is `video-slide-production`.
|
||||||
|
- Reserved future profile `ppt-page-production` may use `docs/cases/`, but must be designed when the first real PPT task needs it.
|
||||||
|
- `visual-system/` is the production authority for slide work.
|
||||||
|
- Style continuity must use `visual-system/style/style-prompt-master.md`.
|
||||||
|
- Character continuity must use `visual-system/characters/character-reference-registry.md` and active character image references.
|
||||||
|
- Visible character identity cannot be generated from text-only prompts when identity matters.
|
||||||
|
- Slide prompts must use the `gpt-image-2` Skill Advisor / host-native workflow.
|
||||||
|
- Review defaults to local-only. Do not call Minimax MCP or other external vision/review services unless the user explicitly authorizes that task.
|
||||||
|
|
|
||||||
|
|
@ -36,6 +36,7 @@ projects/
|
||||||
slides.md
|
slides.md
|
||||||
s01/
|
s01/
|
||||||
s02/
|
s02/
|
||||||
|
tasks/
|
||||||
```
|
```
|
||||||
|
|
||||||
Use root-level `handoff/` for repository-level, cross-project, series-level, or context-window handoff notes.
|
Use root-level `handoff/` for repository-level, cross-project, series-level, or context-window handoff notes.
|
||||||
|
|
@ -199,6 +200,58 @@ slides/
|
||||||
|
|
||||||
All files inside `sNN/` must carry the `sNN` prefix. Iteration files use `sNN-vN-type.ext`, so files from the same version sort together.
|
All files inside `sNN/` must carry the `sNN` prefix. Iteration files use `sNN-vN-type.ext`, so files from the same version sort together.
|
||||||
|
|
||||||
|
### Slide Task Orchestration
|
||||||
|
|
||||||
|
For long or context-heavy production, use local slide task orchestration:
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/workflows/slide-task-orchestration.md
|
||||||
|
docs/workflows/slide-task-templates.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Project-local task records go under:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/<project>/tasks/<task-id>/
|
||||||
|
```
|
||||||
|
|
||||||
|
Task records are for orchestration only. Durable slide artifacts remain under `slides/sNN/`.
|
||||||
|
|
||||||
|
Roles:
|
||||||
|
|
||||||
|
- Main session: receives user instructions, defines worker profile / running mode / slide scope, starts child sessions, and reads handoffs.
|
||||||
|
- Child session: reads shared context, writes per-slide briefs, starts one slide agent per slide, and writes a child-session handoff.
|
||||||
|
- Slide agent: handles exactly one slide, writes the prompt, generates only when allowed, writes review only when required, and returns compact status.
|
||||||
|
|
||||||
|
Defaults:
|
||||||
|
|
||||||
|
- Worker profile for current video / MV work: `video-slide-production`.
|
||||||
|
- Child session capacity: at most 3 slides.
|
||||||
|
- Slide agent capacity: exactly 1 slide.
|
||||||
|
- Execution is sequential by default; do not run child sessions or slide agents in parallel unless the user explicitly changes the rule.
|
||||||
|
- Future `ppt-page-production` work is reserved and may use `docs/cases/`, but it must not inherit video-slide rules blindly.
|
||||||
|
|
||||||
|
The user controls task running mode:
|
||||||
|
|
||||||
|
- `prompt only`: create briefs and prompts; do not generate images.
|
||||||
|
- `prompt and generate`: create briefs and prompts, then generate images for the task's recorded slide scope.
|
||||||
|
|
||||||
|
Task-level generation instructions count as user approval for the named scope and mode. Core, repair, identity-heavy, or otherwise high-risk slides may still pause if the task plan says they require sampling or explicit review.
|
||||||
|
|
||||||
|
Visual-system rules:
|
||||||
|
|
||||||
|
- `visual-system/` is the production authority.
|
||||||
|
- Style continuity must use `visual-system/style/style-prompt-master.md`.
|
||||||
|
- Character continuity must use `visual-system/characters/character-reference-registry.md` and active character reference images.
|
||||||
|
- Visible character identity cannot be generated from text-only prompts when identity matters.
|
||||||
|
- Slide prompts must use the `gpt-image-2` Skill Advisor / host-native workflow.
|
||||||
|
|
||||||
|
Review rules:
|
||||||
|
|
||||||
|
- Review defaults to local-only.
|
||||||
|
- Do not call Minimax MCP or other external vision/review services unless the user explicitly authorizes that task.
|
||||||
|
- Non-core generated slides can be tracked in `tasks/<task-id>/task-log.md` and `slides/slides.md` instead of a full per-slide review.
|
||||||
|
|
||||||
## 9. Investigations
|
## 9. Investigations
|
||||||
|
|
||||||
Use `investigations/` for research reports, experiments, comparisons, draft workflow proposals, and other reviewable evidence.
|
Use `investigations/` for research reports, experiments, comparisons, draft workflow proposals, and other reviewable evidence.
|
||||||
|
|
@ -236,6 +289,8 @@ For project-bound image prompts, Codex must:
|
||||||
- list the source files actually used;
|
- list the source files actually used;
|
||||||
- wait for user approval before image generation.
|
- wait for user approval before image generation.
|
||||||
|
|
||||||
|
A task-level user instruction that records `prompt and generate` plus the slide scope counts as generation approval for that task scope. A task recorded as `prompt only` never authorizes image generation.
|
||||||
|
|
||||||
Direct prompts may exist only as clearly labeled scratch or non-generation-ready drafts. They must be rebuilt through the `gpt-image-2` Skill workflow before use.
|
Direct prompts may exist only as clearly labeled scratch or non-generation-ready drafts. They must be rebuilt through the `gpt-image-2` Skill workflow before use.
|
||||||
|
|
||||||
### Reference-Capable Image Generation
|
### Reference-Capable Image Generation
|
||||||
|
|
@ -322,4 +377,4 @@ C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccpe-agent-consumer-s
|
||||||
|
|
||||||
Do not duplicate canonical CCPE definitions here. Do not hardcode Agent, Lite, Skill, Runtime, or protocol paths as default entrypoints. Use `ccpe-consumption/` for interface notes and future project-local invocation setup records.
|
Do not duplicate canonical CCPE definitions here. Do not hardcode Agent, Lite, Skill, Runtime, or protocol paths as default entrypoints. Use `ccpe-consumption/` for interface notes and future project-local invocation setup records.
|
||||||
|
|
||||||
Local work prompts and agents belong in CCPE. If this workflow is later packaged as deployable software, production/business agent implementation belongs in the target software project, not in Video Workbench.
|
Reusable or canonical expert agents belong in CCPE. Project-local slide task orchestration, child-session records, and slide-agent packets belong in Video Workbench and are not formal CCPE participant output. If this workflow is later packaged as deployable software, production/business agent implementation belongs in the target software project, not in Video Workbench.
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,698 @@
|
||||||
|
# Slide Task Orchestration Plan
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
- Draft date: 2026-06-24.
|
||||||
|
- Scope: local Video Workbench slide-production orchestration.
|
||||||
|
- Status: approved implementation basis.
|
||||||
|
- Project driver: `projects/2026-06-23-在路上`.
|
||||||
|
|
||||||
|
This plan is not a CCPE workflow. It is a local Video Workbench execution protocol for reducing main-session context pressure while keeping slide production traceable and lightweight.
|
||||||
|
|
||||||
|
Active workflow docs created from this plan:
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/workflows/slide-task-orchestration.md
|
||||||
|
docs/workflows/slide-task-templates.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Core Principles
|
||||||
|
|
||||||
|
1. Keep the workflow practical.
|
||||||
|
- This is not a software development project and should not become a heavy governance system.
|
||||||
|
- Record only the minimum task evidence needed for continuation, debugging, and user review.
|
||||||
|
|
||||||
|
2. Protect user attention.
|
||||||
|
- The user and any expert reviewer should not inspect every non-core slide.
|
||||||
|
- User review is reserved for run authorization, core slides, high-risk slides, failed slides, and explicit sampling.
|
||||||
|
|
||||||
|
3. Keep context bounded.
|
||||||
|
- The main session should not carry every slide's full prompt, generation, and review context.
|
||||||
|
- Child sessions reuse common project context for a small number of slides.
|
||||||
|
- One slide agent handles exactly one slide.
|
||||||
|
|
||||||
|
4. Avoid session contamination.
|
||||||
|
- No parallel child sessions by default.
|
||||||
|
- No multi-slide agents.
|
||||||
|
- Batch grouping happens at the session level, not inside a slide agent.
|
||||||
|
|
||||||
|
5. Keep files as the continuation source.
|
||||||
|
- Chat history is not authoritative after compression.
|
||||||
|
- Briefs, prompts, images, returns, logs, and handoffs must be written to disk.
|
||||||
|
|
||||||
|
6. Treat `visual-system/` as the production authority.
|
||||||
|
- slide work must use the active visual-system files rather than reconstructing style or character rules from memory.
|
||||||
|
- Style continuity comes from `visual-system/style/style-prompt-master.md` and its active style reference rules.
|
||||||
|
- Character continuity comes from `visual-system/characters/character-reference-registry.md` and active character reference images.
|
||||||
|
- When a slide contains a visible character and identity matters, text-only prompting is not sufficient.
|
||||||
|
|
||||||
|
7. Use the `gpt-image-2` Skill Advisor workflow for prompt work.
|
||||||
|
- slide prompts must be produced through the `gpt-image-2` Skill workflow.
|
||||||
|
- In the current default path, use Advisor / host-native mode: render the prompt/spec with the Skill, then use the host image tool only when the task allows generation.
|
||||||
|
- Do not freehand final project-bound image prompts from the brief alone.
|
||||||
|
|
||||||
|
## Orchestration Model
|
||||||
|
|
||||||
|
```text
|
||||||
|
main orchestration session
|
||||||
|
-> task plan
|
||||||
|
-> child session 01
|
||||||
|
-> write brief for s05
|
||||||
|
-> start slide agent for s05
|
||||||
|
-> write brief for s21
|
||||||
|
-> start slide agent for s21
|
||||||
|
-> write brief for s14
|
||||||
|
-> start slide agent for s14
|
||||||
|
-> write child-session handoff
|
||||||
|
-> child session 02
|
||||||
|
-> write brief for s25
|
||||||
|
-> start slide agent for s25
|
||||||
|
-> write brief for s33
|
||||||
|
-> start slide agent for s33
|
||||||
|
-> write child-session handoff
|
||||||
|
```
|
||||||
|
|
||||||
|
Default child-session capacity:
|
||||||
|
|
||||||
|
- 3 slides maximum per child session.
|
||||||
|
- Fewer slides are allowed when the slides are identity-heavy, repair-heavy, or otherwise context-expensive.
|
||||||
|
- Child sessions run sequentially, not in parallel.
|
||||||
|
|
||||||
|
Default slide-agent capacity:
|
||||||
|
|
||||||
|
- 1 slide per agent invocation.
|
||||||
|
- The slide agent must not accept a range or batch of slides.
|
||||||
|
|
||||||
|
## Worker Profiles
|
||||||
|
|
||||||
|
This plan implements only the current worker profile:
|
||||||
|
|
||||||
|
```text
|
||||||
|
video-slide-production
|
||||||
|
```
|
||||||
|
|
||||||
|
Current profile behavior:
|
||||||
|
|
||||||
|
- uses project `visual-system/` as the production authority;
|
||||||
|
- uses `slides/` as the slide artifact area;
|
||||||
|
- uses `gpt-image-2` Skill Advisor / host-native prompt workflow;
|
||||||
|
- uses style prompt master and active character reference registry;
|
||||||
|
- has no extra project knowledge base by default.
|
||||||
|
|
||||||
|
Reserved future profile:
|
||||||
|
|
||||||
|
```text
|
||||||
|
ppt-page-production
|
||||||
|
```
|
||||||
|
|
||||||
|
Future profile notes:
|
||||||
|
|
||||||
|
- may use `docs/cases/` as an additional case-pattern knowledge base;
|
||||||
|
- may need page-level brief, prompt, and review structures rather than slide-level structures;
|
||||||
|
- must not inherit video-slide rules blindly;
|
||||||
|
- should be designed when the first real PPT task needs it.
|
||||||
|
|
||||||
|
Task plans must record the worker profile:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Worker Profile: video-slide-production
|
||||||
|
```
|
||||||
|
|
||||||
|
## Directory Model
|
||||||
|
|
||||||
|
Use `tasks/`, not `runs/`, for local 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
|
||||||
|
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
|
||||||
|
```
|
||||||
|
|
||||||
|
Rules:
|
||||||
|
|
||||||
|
- `tasks/<task-id>/` records orchestration and agent communication.
|
||||||
|
- `slides/sNN/` remains the durable home for slide artifacts.
|
||||||
|
- Task files should not duplicate full prompts unless needed for status or debugging.
|
||||||
|
- Task records should link to slide artifacts by path.
|
||||||
|
|
||||||
|
Suggested task id pattern:
|
||||||
|
|
||||||
|
```text
|
||||||
|
YYYY-MM-DD-<short-purpose>
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/
|
||||||
|
```
|
||||||
|
|
||||||
|
## Main Session Responsibilities
|
||||||
|
|
||||||
|
The main session is the only session that talks with the user by default.
|
||||||
|
|
||||||
|
The main session should:
|
||||||
|
|
||||||
|
- receive the user instruction;
|
||||||
|
- define the task scope and allowed running mode;
|
||||||
|
- decide the child-session split;
|
||||||
|
- create or update `task-plan.md`;
|
||||||
|
- start child sessions sequentially;
|
||||||
|
- read each `child-session-handoff.md`;
|
||||||
|
- ask the user only for real decisions, blockers, or requested sampling;
|
||||||
|
- update `task-log.md` with compact status.
|
||||||
|
|
||||||
|
The main session should not:
|
||||||
|
|
||||||
|
- write per-slide briefs by default;
|
||||||
|
- write final prompts by default;
|
||||||
|
- generate images by default;
|
||||||
|
- review every non-core image by default;
|
||||||
|
- carry all slide context in chat.
|
||||||
|
|
||||||
|
## Child Session Responsibilities
|
||||||
|
|
||||||
|
The child session is the small-batch context holder.
|
||||||
|
|
||||||
|
The child session should:
|
||||||
|
|
||||||
|
- read the project rules and the task plan;
|
||||||
|
- read the shared project context needed for the assigned slides;
|
||||||
|
- read the active `visual-system` materials needed for the assigned slides, especially:
|
||||||
|
- `visual-system/visual-system.md`;
|
||||||
|
- `visual-system/style/style-prompt-master.md`;
|
||||||
|
- `visual-system/characters/character-reference-registry.md` when a slide contains a visible character;
|
||||||
|
- 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 that expected files were written;
|
||||||
|
- write `child-session-handoff.md` before ending.
|
||||||
|
|
||||||
|
The child session should not:
|
||||||
|
|
||||||
|
- talk to the user unless explicitly instructed by the main session;
|
||||||
|
- process more than 3 slides by default;
|
||||||
|
- run slide agents in parallel;
|
||||||
|
- generate final prompts itself unless the slide-agent path is unavailable;
|
||||||
|
- turn task records into a full audit package.
|
||||||
|
|
||||||
|
## Slide Agent Responsibilities
|
||||||
|
|
||||||
|
The slide agent is the single-slide worker.
|
||||||
|
|
||||||
|
The slide agent should:
|
||||||
|
|
||||||
|
- read the provided packet;
|
||||||
|
- read the slide brief;
|
||||||
|
- follow the `gpt-image-2` Skill Advisor / host-native prompt workflow recorded in the packet;
|
||||||
|
- use the brief's `Reference Plan` and preserve the active visual-system reference choices in `sNN-vN-prompt.md`;
|
||||||
|
- write or update `sNN-vN-prompt.md`;
|
||||||
|
- generate the image only when the packet allows generation;
|
||||||
|
- write `sNN-vN-review.md` only when required;
|
||||||
|
- write a short return file.
|
||||||
|
|
||||||
|
The slide agent should not:
|
||||||
|
|
||||||
|
- write the brief in the default workflow;
|
||||||
|
- process a second slide;
|
||||||
|
- infer task scope beyond the packet;
|
||||||
|
- replace style-master guidance with an ad hoc style paragraph;
|
||||||
|
- replace active character image references with text-only identity description when the slide needs character continuity;
|
||||||
|
- use archived character or style references unless the packet explicitly reopens them;
|
||||||
|
- call Minimax MCP or external review tools by default.
|
||||||
|
|
||||||
|
## Slide Agent Running Modes
|
||||||
|
|
||||||
|
The main session chooses the running mode for each task.
|
||||||
|
|
||||||
|
### Mode 1: 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 the required character reference image(s)
|
||||||
|
-> slide agent generates image
|
||||||
|
-> slide agent writes review if required
|
||||||
|
-> slide agent return
|
||||||
|
```
|
||||||
|
|
||||||
|
Use for:
|
||||||
|
|
||||||
|
- non-core production after task-level authorization;
|
||||||
|
- low-risk environment slides;
|
||||||
|
- continuation work where the prompt pattern is already stable.
|
||||||
|
|
||||||
|
### Mode 2: 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.
|
||||||
|
|
||||||
|
Use for:
|
||||||
|
|
||||||
|
- high-risk identity slides;
|
||||||
|
- new project first-pass validation;
|
||||||
|
- prompt sampling in ChatGPT or another platform;
|
||||||
|
- any task where the user wants to inspect prompts before generation.
|
||||||
|
|
||||||
|
## Task Authorization Rule
|
||||||
|
|
||||||
|
The user gives concrete instructions to the main session for:
|
||||||
|
|
||||||
|
- agent running mode;
|
||||||
|
- slide range;
|
||||||
|
- generation permission;
|
||||||
|
- review/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 range and exceptions.
|
||||||
|
|
||||||
|
Core, repair, identity-heavy, or otherwise high-risk slides may still require prompt-only handling or an explicit pause if the task plan says so.
|
||||||
|
|
||||||
|
## Brief Structure
|
||||||
|
|
||||||
|
The brief is the universal slide execution card. It has the same structure whether or not GPT supplied a dedicated single-slide skeleton.
|
||||||
|
|
||||||
|
Recommended structure:
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Brief V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Source Basis
|
||||||
|
## slide Function
|
||||||
|
## First Read
|
||||||
|
## Risk Class
|
||||||
|
## Reference Plan
|
||||||
|
## Visual Requirements
|
||||||
|
## Character Handling
|
||||||
|
## Composition / Scale
|
||||||
|
## Light / Color / Texture
|
||||||
|
## Forbidden Drift
|
||||||
|
## Acceptance Checklist
|
||||||
|
## Prompt Handoff
|
||||||
|
```
|
||||||
|
|
||||||
|
### Brief Field Rules
|
||||||
|
|
||||||
|
`Status` records document status, task id, slide id, version, and current execution state.
|
||||||
|
|
||||||
|
`Source Basis` lists only the key sources used for this brief. Do not turn this into a full review manifest.
|
||||||
|
|
||||||
|
`slide Function` states what this slide does in the sequence.
|
||||||
|
|
||||||
|
`First Read` states what the viewer should notice first.
|
||||||
|
|
||||||
|
`Risk Class` classifies the slide, for example:
|
||||||
|
|
||||||
|
```text
|
||||||
|
environment-only
|
||||||
|
object/body detail
|
||||||
|
distant human
|
||||||
|
medium human
|
||||||
|
close/face human
|
||||||
|
core motif
|
||||||
|
repair
|
||||||
|
```
|
||||||
|
|
||||||
|
`Reference Plan` names the required style module and character references, or says `none` with a reason.
|
||||||
|
|
||||||
|
For style, the reference plan must point to the active style module in:
|
||||||
|
|
||||||
|
```text
|
||||||
|
visual-system/style/style-prompt-master.md
|
||||||
|
```
|
||||||
|
|
||||||
|
For visible character slides, the reference plan must select active character reference images from:
|
||||||
|
|
||||||
|
```text
|
||||||
|
visual-system/characters/character-reference-registry.md
|
||||||
|
```
|
||||||
|
|
||||||
|
If the slide contains a visible character and identity matters, the brief must say which reference image should be loaded for generation. Text-only character description is not enough for those slides.
|
||||||
|
|
||||||
|
`Visual Requirements` lists the positive content requirements.
|
||||||
|
|
||||||
|
`Character Handling` records visibility, identity burden, scale, posture, and prop continuity.
|
||||||
|
|
||||||
|
`Composition / Scale` records frame logic, figure size, first-read hierarchy, and placement.
|
||||||
|
|
||||||
|
`Light / Color / Texture` records the local light and material rules.
|
||||||
|
|
||||||
|
`Forbidden Drift` records the main failure modes.
|
||||||
|
|
||||||
|
`Acceptance Checklist` is the minimum local check list.
|
||||||
|
|
||||||
|
`Prompt Handoff` tells the slide agent what the prompt must carry into generation.
|
||||||
|
|
||||||
|
## Prompt Structure
|
||||||
|
|
||||||
|
The prompt file is an attachment to the brief. It should be directly runnable or easy to use for cross-platform prompt validation.
|
||||||
|
|
||||||
|
Recommended structure:
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Prompt V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Based On Brief
|
||||||
|
## Reference Inputs
|
||||||
|
## Operation Notes
|
||||||
|
## Final Prompt
|
||||||
|
## Negative / Avoid
|
||||||
|
## Output Intent
|
||||||
|
```
|
||||||
|
|
||||||
|
### Prompt Field Rules
|
||||||
|
|
||||||
|
`Status` records slide id, version, mode, and execution state.
|
||||||
|
|
||||||
|
`Based On Brief` links to the brief path.
|
||||||
|
|
||||||
|
`Reference Inputs` lists actual image references and roles.
|
||||||
|
|
||||||
|
Every prompt must preserve the visual-system usage from the brief:
|
||||||
|
|
||||||
|
- style module from `visual-system/style/style-prompt-master.md`;
|
||||||
|
- active style reference path(s), when applicable;
|
||||||
|
- active character reference path(s), when a character is visible and identity matters;
|
||||||
|
- explicit `none` with reason when no character reference should be used.
|
||||||
|
|
||||||
|
When using reference-capable host generation, use explicit visible-context roles:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Image 1: identity reference
|
||||||
|
Image 2: style reference
|
||||||
|
```
|
||||||
|
|
||||||
|
`Operation Notes` records only generation-relevant steps, such as loading reference images before calling the host image tool.
|
||||||
|
|
||||||
|
For character-visible slides, `Operation Notes` must state whether image-to-image / reference-by-visible-context generation is required. 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.
|
||||||
|
|
||||||
|
`Final Prompt` should be rendered through the `gpt-image-2` Skill Advisor workflow and should be copyable into another image-generation platform with minimal cleanup.
|
||||||
|
|
||||||
|
`Negative / Avoid` should be copyable as a negative prompt or avoid list.
|
||||||
|
|
||||||
|
`Output Intent` records the intended project output path and cross-validation note if relevant.
|
||||||
|
|
||||||
|
Do not put these in normal prompt files unless needed for the run:
|
||||||
|
|
||||||
|
- full project explanation;
|
||||||
|
- long source-file audit;
|
||||||
|
- detailed Skill file narrative;
|
||||||
|
- review conclusions;
|
||||||
|
- task orchestration history.
|
||||||
|
|
||||||
|
## Review Structure
|
||||||
|
|
||||||
|
Reviews are optional by default.
|
||||||
|
|
||||||
|
Create `sNN-vN-review.md` only when:
|
||||||
|
|
||||||
|
- the slide is a core trial slide;
|
||||||
|
- the slide is identity-heavy;
|
||||||
|
- the slide is a repair target;
|
||||||
|
- the user explicitly requests a review record;
|
||||||
|
- the agent detects likely failure or uncertainty;
|
||||||
|
- the image is being accepted as a durable reference.
|
||||||
|
|
||||||
|
Recommended structure:
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Review V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Generation Trace
|
||||||
|
## Local File Check
|
||||||
|
## Local Visual Check
|
||||||
|
## Acceptance Checklist
|
||||||
|
## Issues
|
||||||
|
## Decision / Next Action
|
||||||
|
```
|
||||||
|
|
||||||
|
Default review rule:
|
||||||
|
|
||||||
|
- Use local capabilities 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 visual-system character reference was actually loaded or whether the run was only text-guided.
|
||||||
|
- For style-sensitive slides, check whether the prompt used the active style module rather than a one-off style paragraph.
|
||||||
|
|
||||||
|
Non-core generated slides may instead be recorded in:
|
||||||
|
|
||||||
|
```text
|
||||||
|
tasks/<task-id>/task-log.md
|
||||||
|
slides/slides.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Task File Structures
|
||||||
|
|
||||||
|
### `task-plan.md`
|
||||||
|
|
||||||
|
```text
|
||||||
|
# <Task Title>
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## User Instruction
|
||||||
|
## Worker Profile
|
||||||
|
## Running Mode
|
||||||
|
## slide Scope
|
||||||
|
## Child Session Split
|
||||||
|
## Shared Context
|
||||||
|
## Rules
|
||||||
|
## Visual-System Usage
|
||||||
|
## Expected Outputs
|
||||||
|
## User Review / Sampling Plan
|
||||||
|
## Stop Conditions
|
||||||
|
```
|
||||||
|
|
||||||
|
### `child-session-plan.md`
|
||||||
|
|
||||||
|
```text
|
||||||
|
# Child Session NN Plan
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Parent Task
|
||||||
|
## Assigned slides
|
||||||
|
## Shared Context To Read
|
||||||
|
## Visual-System Files To Read
|
||||||
|
## Per-slide Work Order
|
||||||
|
## Agent Packet Paths
|
||||||
|
## Stop Conditions
|
||||||
|
```
|
||||||
|
|
||||||
|
### `slide-agent-packet.md`
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Agent Packet V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Target slide
|
||||||
|
## Allowed Actions
|
||||||
|
## Input Files
|
||||||
|
## Output Files
|
||||||
|
## Reference Roles
|
||||||
|
## Visual-System Requirements
|
||||||
|
## Gpt-Image-2 Advisor Rule
|
||||||
|
## Generation Rule
|
||||||
|
## Review Rule
|
||||||
|
## Return File
|
||||||
|
```
|
||||||
|
|
||||||
|
### `slide-agent-return.md`
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Agent Return V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Files Written
|
||||||
|
## Generation Result
|
||||||
|
## Review Result
|
||||||
|
## Blockers
|
||||||
|
## Next Action
|
||||||
|
```
|
||||||
|
|
||||||
|
### `child-session-handoff.md`
|
||||||
|
|
||||||
|
```text
|
||||||
|
# Child Session NN Handoff
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Completed slides
|
||||||
|
## Files Written
|
||||||
|
## Problems / Repairs Needed
|
||||||
|
## User Decisions Needed
|
||||||
|
## Next Session Input
|
||||||
|
```
|
||||||
|
|
||||||
|
### `task-log.md`
|
||||||
|
|
||||||
|
Keep this compact. It is not a full audit.
|
||||||
|
|
||||||
|
```text
|
||||||
|
# Task Log
|
||||||
|
|
||||||
|
## Status
|
||||||
|
## Timeline
|
||||||
|
## Child Session Results
|
||||||
|
## slide Status Summary
|
||||||
|
## Open Decisions
|
||||||
|
```
|
||||||
|
|
||||||
|
## Planned File And Folder Changes
|
||||||
|
|
||||||
|
This plan should be implemented after user review.
|
||||||
|
|
||||||
|
### Add Docs
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/workflows/slide-task-orchestration.md
|
||||||
|
docs/workflows/slide-brief-structure.md
|
||||||
|
docs/workflows/slide-prompt-structure.md
|
||||||
|
docs/workflows/slide-review-structure.md
|
||||||
|
docs/workflows/slide-agent-packet.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Possible consolidation:
|
||||||
|
|
||||||
|
- If this is too many files, keep one stable workflow document and one templates document.
|
||||||
|
|
||||||
|
### Add Templates
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/templates/task-plan-template.md
|
||||||
|
docs/templates/child-session-plan-template.md
|
||||||
|
docs/templates/child-session-handoff-template.md
|
||||||
|
docs/templates/slide-agent-packet-template.md
|
||||||
|
docs/templates/slide-agent-return-template.md
|
||||||
|
docs/templates/slide-brief-template.md
|
||||||
|
docs/templates/slide-prompt-template.md
|
||||||
|
docs/templates/slide-review-template.md
|
||||||
|
```
|
||||||
|
|
||||||
|
### Update Workspace Rules
|
||||||
|
|
||||||
|
```text
|
||||||
|
VIDEO_WORKBENCH.md
|
||||||
|
AGENTS.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected updates:
|
||||||
|
|
||||||
|
- add `tasks/` as the local task orchestration directory;
|
||||||
|
- define main session / child session / slide agent boundaries;
|
||||||
|
- define the two slide-agent running modes;
|
||||||
|
- state that task-level user instruction controls generation authorization;
|
||||||
|
- state that child sessions and slide agents must use active `visual-system` materials;
|
||||||
|
- state that visible character identity requires actual character image references, not text-only prompting;
|
||||||
|
- state that slide prompts must use the `gpt-image-2` Skill Advisor workflow;
|
||||||
|
- state that review defaults to local-only and does not call Minimax MCP.
|
||||||
|
|
||||||
|
### Add Project Task Directory During First Trial
|
||||||
|
|
||||||
|
For the `在路上` character-consistency trial:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/
|
||||||
|
```
|
||||||
|
|
||||||
|
Expected substructure:
|
||||||
|
|
||||||
|
```text
|
||||||
|
task-plan.md
|
||||||
|
task-log.md
|
||||||
|
session-01/
|
||||||
|
session-02/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Existing Slide Artifact Changes During First Trial
|
||||||
|
|
||||||
|
Likely generated or updated:
|
||||||
|
|
||||||
|
```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
|
||||||
|
```
|
||||||
|
|
||||||
|
Image and review files depend on task running mode.
|
||||||
|
|
||||||
|
## First Trial Recommendation
|
||||||
|
|
||||||
|
Use the character-consistency slides as the first orchestration trial.
|
||||||
|
|
||||||
|
Task:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/
|
||||||
|
```
|
||||||
|
|
||||||
|
Child session split:
|
||||||
|
|
||||||
|
```text
|
||||||
|
session-01: s05 -> s21 -> s14
|
||||||
|
session-02: s25 -> s33
|
||||||
|
```
|
||||||
|
|
||||||
|
Recommended first running mode:
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompt only
|
||||||
|
```
|
||||||
|
|
||||||
|
Reason:
|
||||||
|
|
||||||
|
- This validates the new brief and prompt structure without spending image-generation context.
|
||||||
|
- The user can sample prompts externally if desired.
|
||||||
|
- A later task can use the same prompts for generation.
|
||||||
|
|
||||||
|
If the user chooses `prompt and generate`, the task plan must record that instruction and the exact slide scope.
|
||||||
|
|
||||||
|
## Open Implementation Decisions
|
||||||
|
|
||||||
|
1. Whether to split the stable docs into five files or keep a single workflow document plus templates.
|
||||||
|
2. Whether to update `AGENTS.md` immediately or only update `VIDEO_WORKBENCH.md` for this local workflow.
|
||||||
|
3. Whether the first trial should be `prompt only` or `prompt and generate`.
|
||||||
|
4. Whether old broad-run candidate images for `s05`, `s14`, `s21`, `s25`, and `s33` should be marked as comparison-only before the character-consistency task starts.
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -0,0 +1,248 @@
|
||||||
|
# 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
|
||||||
|
```
|
||||||
|
|
@ -0,0 +1,236 @@
|
||||||
|
# Slide Task Templates
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
- Status: active template reference.
|
||||||
|
- Companion workflow: `docs/workflows/slide-task-orchestration.md`.
|
||||||
|
|
||||||
|
Copy these structures into project-local task and slide files as needed. Keep them compact; do not turn them into full audit reports.
|
||||||
|
|
||||||
|
## Task Plan
|
||||||
|
|
||||||
|
```text
|
||||||
|
# <Task Title>
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
- Task id:
|
||||||
|
- Worker profile:
|
||||||
|
- Running mode:
|
||||||
|
- Status:
|
||||||
|
|
||||||
|
## User Instruction
|
||||||
|
|
||||||
|
## Slide Scope
|
||||||
|
|
||||||
|
## Child Session Split
|
||||||
|
|
||||||
|
## Shared Context
|
||||||
|
|
||||||
|
## Visual-System Usage
|
||||||
|
|
||||||
|
## Rules
|
||||||
|
|
||||||
|
## Expected Outputs
|
||||||
|
|
||||||
|
## User Review / Sampling Plan
|
||||||
|
|
||||||
|
## Stop Conditions
|
||||||
|
```
|
||||||
|
|
||||||
|
## Task Log
|
||||||
|
|
||||||
|
```text
|
||||||
|
# Task Log
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Timeline
|
||||||
|
|
||||||
|
## Child Session Results
|
||||||
|
|
||||||
|
## Slide Status Summary
|
||||||
|
|
||||||
|
## Open Decisions
|
||||||
|
```
|
||||||
|
|
||||||
|
## Child Session Plan
|
||||||
|
|
||||||
|
```text
|
||||||
|
# Child Session NN Plan
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Parent Task
|
||||||
|
|
||||||
|
## Assigned Slides
|
||||||
|
|
||||||
|
## Shared Context To Read
|
||||||
|
|
||||||
|
## Visual-System Files To Read
|
||||||
|
|
||||||
|
## Per-Slide Work Order
|
||||||
|
|
||||||
|
## Agent Packet Paths
|
||||||
|
|
||||||
|
## Stop Conditions
|
||||||
|
```
|
||||||
|
|
||||||
|
## Child Session Handoff
|
||||||
|
|
||||||
|
```text
|
||||||
|
# Child Session NN Handoff
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Completed Slides
|
||||||
|
|
||||||
|
## Files Written
|
||||||
|
|
||||||
|
## Problems / Repairs Needed
|
||||||
|
|
||||||
|
## User Decisions Needed
|
||||||
|
|
||||||
|
## Next Session Input
|
||||||
|
```
|
||||||
|
|
||||||
|
## Slide Agent Packet
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Agent Packet V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Target Slide
|
||||||
|
|
||||||
|
## Allowed Actions
|
||||||
|
|
||||||
|
## Input Files
|
||||||
|
|
||||||
|
## Output Files
|
||||||
|
|
||||||
|
## Reference Roles
|
||||||
|
|
||||||
|
## Visual-System Requirements
|
||||||
|
|
||||||
|
## Gpt-Image-2 Advisor Rule
|
||||||
|
|
||||||
|
## Generation Rule
|
||||||
|
|
||||||
|
## Review Rule
|
||||||
|
|
||||||
|
## Return File
|
||||||
|
```
|
||||||
|
|
||||||
|
## Slide Agent Return
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Agent Return V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Files Written
|
||||||
|
|
||||||
|
## Generation Result
|
||||||
|
|
||||||
|
## Review Result
|
||||||
|
|
||||||
|
## Blockers
|
||||||
|
|
||||||
|
## Next Action
|
||||||
|
```
|
||||||
|
|
||||||
|
## Slide Brief
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Brief V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Source Basis
|
||||||
|
|
||||||
|
## Slide Function
|
||||||
|
|
||||||
|
## First Read
|
||||||
|
|
||||||
|
## Risk Class
|
||||||
|
|
||||||
|
## Reference Plan
|
||||||
|
|
||||||
|
## Visual Requirements
|
||||||
|
|
||||||
|
## Character Handling
|
||||||
|
|
||||||
|
## Composition / Scale
|
||||||
|
|
||||||
|
## Light / Color / Texture
|
||||||
|
|
||||||
|
## Forbidden Drift
|
||||||
|
|
||||||
|
## Acceptance Checklist
|
||||||
|
|
||||||
|
## Prompt Handoff
|
||||||
|
```
|
||||||
|
|
||||||
|
Brief field rules:
|
||||||
|
|
||||||
|
- `Source Basis` lists only key sources.
|
||||||
|
- `Risk Class` uses values such as `environment-only`, `object/body detail`, `distant human`, `medium human`, `close/face human`, `core motif`, or `repair`.
|
||||||
|
- `Reference Plan` must name the active style module and any active character references.
|
||||||
|
- Visible character slides must select character reference images from `visual-system/characters/character-reference-registry.md`.
|
||||||
|
- `Prompt Handoff` tells the slide agent what must be carried into the prompt.
|
||||||
|
|
||||||
|
## Slide Prompt
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Prompt V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Based On Brief
|
||||||
|
|
||||||
|
## Reference Inputs
|
||||||
|
|
||||||
|
## Operation Notes
|
||||||
|
|
||||||
|
## Final Prompt
|
||||||
|
|
||||||
|
## Negative / Avoid
|
||||||
|
|
||||||
|
## Output Intent
|
||||||
|
```
|
||||||
|
|
||||||
|
Prompt field rules:
|
||||||
|
|
||||||
|
- `Based On Brief` links to `sNN-vN-brief.md`.
|
||||||
|
- `Reference Inputs` lists actual image references and roles.
|
||||||
|
- `Operation Notes` records only generation-relevant steps.
|
||||||
|
- `Final Prompt` should be copyable into another image-generation platform with minimal cleanup.
|
||||||
|
- Do not put long project explanation, detailed source audit, review conclusions, or task orchestration history in normal prompt files.
|
||||||
|
|
||||||
|
## Slide Review
|
||||||
|
|
||||||
|
```text
|
||||||
|
# S-NN Slide Review V1
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
## Generation Trace
|
||||||
|
|
||||||
|
## Local File Check
|
||||||
|
|
||||||
|
## Local Visual Check
|
||||||
|
|
||||||
|
## Acceptance Checklist
|
||||||
|
|
||||||
|
## Issues
|
||||||
|
|
||||||
|
## Decision / Next Action
|
||||||
|
```
|
||||||
|
|
||||||
|
Review field rules:
|
||||||
|
|
||||||
|
- Use local capabilities by default.
|
||||||
|
- Do not call Minimax MCP unless the user explicitly authorizes it for the task.
|
||||||
|
- For character-visible slides, record whether the required character reference image was loaded.
|
||||||
|
- For style-sensitive slides, record whether the active style module was used.
|
||||||
|
|
@ -0,0 +1,294 @@
|
||||||
|
# Character Consistency Slide Task Handoff
|
||||||
|
|
||||||
|
## Status
|
||||||
|
|
||||||
|
- Date: 2026-06-24.
|
||||||
|
- Project: `projects/2026-06-23-在路上`.
|
||||||
|
- Purpose: prepare the next session to test the new local slide task orchestration workflow with the five character-consistency slides.
|
||||||
|
- Current state: workflow rules and templates have been drafted and promoted into workspace rules, but the actual character-consistency task directory has not been created yet.
|
||||||
|
|
||||||
|
This handoff is not a CCPE invocation. It is for local Video Workbench slide task orchestration.
|
||||||
|
|
||||||
|
## Current Uncommitted Workflow Changes
|
||||||
|
|
||||||
|
At the time this handoff was written, these workflow changes are in the working tree:
|
||||||
|
|
||||||
|
```text
|
||||||
|
AGENTS.md
|
||||||
|
VIDEO_WORKBENCH.md
|
||||||
|
docs/workflows/slide-task-orchestration.md
|
||||||
|
docs/workflows/slide-task-templates.md
|
||||||
|
docs/workflows/slide-task-orchestration-plan.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Check `git status --short` before continuing.
|
||||||
|
|
||||||
|
## Must Read First
|
||||||
|
|
||||||
|
Read in this order:
|
||||||
|
|
||||||
|
1. `AGENTS.md`
|
||||||
|
- UTF-8 rules.
|
||||||
|
- `gpt-image-2` Skill Advisor workflow.
|
||||||
|
- task-level authorization rule.
|
||||||
|
- local slide task workflow rules.
|
||||||
|
2. `VIDEO_WORKBENCH.md`
|
||||||
|
- project layout.
|
||||||
|
- `slides/sNN/sNN-vN-type.ext` naming.
|
||||||
|
- `tasks/` orchestration model.
|
||||||
|
- reference-capable generation rule.
|
||||||
|
3. `docs/workflows/slide-task-orchestration.md`
|
||||||
|
- active main session / child session / slide agent contract.
|
||||||
|
4. `docs/workflows/slide-task-templates.md`
|
||||||
|
- exact task, child-session, packet, return, brief, prompt, and review structures.
|
||||||
|
5. `projects/2026-06-23-在路上/project.md`
|
||||||
|
6. `projects/2026-06-23-在路上/execution-plan.md`
|
||||||
|
7. `projects/2026-06-23-在路上/visual-system/visual-system.md`
|
||||||
|
8. `projects/2026-06-23-在路上/visual-system/style/style-prompt-master.md`
|
||||||
|
9. `projects/2026-06-23-在路上/visual-system/characters/character-reference-registry.md`
|
||||||
|
10. `projects/2026-06-23-在路上/intake/阶段五-人物一致性单镜.md`
|
||||||
|
11. `projects/2026-06-23-在路上/slides/slides.md`
|
||||||
|
12. `projects/2026-06-23-在路上/slides/broad-generation-self-audit-v1.md`
|
||||||
|
|
||||||
|
## Task To Create Next
|
||||||
|
|
||||||
|
Use this task directory:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/
|
||||||
|
```
|
||||||
|
|
||||||
|
Worker profile:
|
||||||
|
|
||||||
|
```text
|
||||||
|
video-slide-production
|
||||||
|
```
|
||||||
|
|
||||||
|
Default slide scope:
|
||||||
|
|
||||||
|
```text
|
||||||
|
s05
|
||||||
|
s21
|
||||||
|
s14
|
||||||
|
s25
|
||||||
|
s33
|
||||||
|
```
|
||||||
|
|
||||||
|
Default child-session split:
|
||||||
|
|
||||||
|
```text
|
||||||
|
session-01: s05 -> s21 -> s14
|
||||||
|
session-02: s25 -> s33
|
||||||
|
```
|
||||||
|
|
||||||
|
Run child sessions sequentially. Do not parallelize.
|
||||||
|
|
||||||
|
## Required User Instruction Before Starting
|
||||||
|
|
||||||
|
The next main session should ask for or receive a concrete task running mode before creating prompts or generating images:
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompt only
|
||||||
|
```
|
||||||
|
|
||||||
|
or:
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompt and generate
|
||||||
|
```
|
||||||
|
|
||||||
|
If the mode is `prompt only`:
|
||||||
|
|
||||||
|
- create `task-plan.md`;
|
||||||
|
- create child-session plans;
|
||||||
|
- write `sNN-v1-brief.md`;
|
||||||
|
- create slide-agent packets;
|
||||||
|
- have slide agents write `sNN-v1-prompt.md`;
|
||||||
|
- do not generate images.
|
||||||
|
|
||||||
|
If the mode is `prompt and generate`:
|
||||||
|
|
||||||
|
- record the mode and exact slide scope in `task-plan.md`;
|
||||||
|
- create briefs and prompts;
|
||||||
|
- load required character reference images before generation;
|
||||||
|
- generate new images only for the authorized scope;
|
||||||
|
- write review files only where required.
|
||||||
|
|
||||||
|
## Current Slide-Specific Context
|
||||||
|
|
||||||
|
The five test slides are from:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/intake/阶段五-人物一致性单镜.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Purpose:
|
||||||
|
|
||||||
|
> Let the audience believe that the traveler remains the same person through back view, side/back action, half-profile, hand/body detail, and restrained emotional close-up.
|
||||||
|
|
||||||
|
Recommended order:
|
||||||
|
|
||||||
|
```text
|
||||||
|
s05 -> s21 -> s14 -> s25 -> s33
|
||||||
|
```
|
||||||
|
|
||||||
|
Slide roles:
|
||||||
|
|
||||||
|
| Slide | Function | Identity risk |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `s05` | backpack / coat / back silhouette baseline | medium human |
|
||||||
|
| `s21` | side/back motion, backpack adjustment, fire direction | medium human |
|
||||||
|
| `s14` | half-profile tired dignity in city edge | close / face human |
|
||||||
|
| `s25` | hand/body dust action and face edge | close / detail human |
|
||||||
|
| `s33` | restrained emotional half-profile | close / face human |
|
||||||
|
|
||||||
|
## Old Broad-Run Images
|
||||||
|
|
||||||
|
The following images already exist from the flawed broad run:
|
||||||
|
|
||||||
|
```text
|
||||||
|
slides/s05/s05-v1-image.png
|
||||||
|
slides/s14/s14-v1-image.png
|
||||||
|
slides/s21/s21-v1-image.png
|
||||||
|
slides/s25/s25-v1-image.png
|
||||||
|
slides/s33/s33-v1-image.png
|
||||||
|
```
|
||||||
|
|
||||||
|
Do not treat them as accepted finals.
|
||||||
|
|
||||||
|
Use them only as comparison or failure context unless the user explicitly asks to salvage one.
|
||||||
|
|
||||||
|
The broad-run failure was:
|
||||||
|
|
||||||
|
- no per-slide brief;
|
||||||
|
- no per-slide prompt;
|
||||||
|
- text-only character description;
|
||||||
|
- accepted character reference images were not actually loaded;
|
||||||
|
- high-risk identity slides drifted.
|
||||||
|
|
||||||
|
## Visual-System Requirements
|
||||||
|
|
||||||
|
The child session and slide agent must use active `visual-system/` materials.
|
||||||
|
|
||||||
|
Style:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/visual-system/style/style-prompt-master.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Character:
|
||||||
|
|
||||||
|
```text
|
||||||
|
projects/2026-06-23-在路上/visual-system/characters/character-reference-registry.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Rules:
|
||||||
|
|
||||||
|
- Style prompt language must come from the active style master.
|
||||||
|
- Character references must be selected from the active character registry.
|
||||||
|
- Visible character identity must not be generated from text-only prompts.
|
||||||
|
- For near / identity-heavy slides, prefer matching crop references.
|
||||||
|
- For back / side / walking slides, prefer matching crop or transparent slice by visible direction.
|
||||||
|
- The prompt must name loaded reference roles such as `Image 1: identity reference`.
|
||||||
|
|
||||||
|
## Expected Per-Slide Artifacts
|
||||||
|
|
||||||
|
For each slide:
|
||||||
|
|
||||||
|
```text
|
||||||
|
slides/sNN/sNN-v1-brief.md
|
||||||
|
slides/sNN/sNN-v1-prompt.md
|
||||||
|
```
|
||||||
|
|
||||||
|
If generation is authorized and succeeds:
|
||||||
|
|
||||||
|
```text
|
||||||
|
slides/sNN/sNN-v1-image.png
|
||||||
|
```
|
||||||
|
|
||||||
|
If review is required:
|
||||||
|
|
||||||
|
```text
|
||||||
|
slides/sNN/sNN-v1-review.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Review is expected for this character-consistency test if images are generated, because these slides are identity-sensitive.
|
||||||
|
|
||||||
|
## Expected Task Artifacts
|
||||||
|
|
||||||
|
Task root:
|
||||||
|
|
||||||
|
```text
|
||||||
|
task-plan.md
|
||||||
|
task-log.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Session 01:
|
||||||
|
|
||||||
|
```text
|
||||||
|
session-01/child-session-plan.md
|
||||||
|
session-01/child-session-handoff.md
|
||||||
|
session-01/packets/s05-v1-slide-agent-packet.md
|
||||||
|
session-01/packets/s21-v1-slide-agent-packet.md
|
||||||
|
session-01/packets/s14-v1-slide-agent-packet.md
|
||||||
|
session-01/returns/s05-v1-slide-agent-return.md
|
||||||
|
session-01/returns/s21-v1-slide-agent-return.md
|
||||||
|
session-01/returns/s14-v1-slide-agent-return.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Session 02:
|
||||||
|
|
||||||
|
```text
|
||||||
|
session-02/child-session-plan.md
|
||||||
|
session-02/child-session-handoff.md
|
||||||
|
session-02/packets/s25-v1-slide-agent-packet.md
|
||||||
|
session-02/packets/s33-v1-slide-agent-packet.md
|
||||||
|
session-02/returns/s25-v1-slide-agent-return.md
|
||||||
|
session-02/returns/s33-v1-slide-agent-return.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Do Not Do
|
||||||
|
|
||||||
|
- Do not invoke CCPE for this workflow.
|
||||||
|
- Do not ask GPT V2 for final prompts.
|
||||||
|
- Do not use Minimax MCP for review by default.
|
||||||
|
- Do not generate visible-character identity slides from text-only prompts.
|
||||||
|
- Do not use archived character or style files unless a packet explicitly reopens them.
|
||||||
|
- Do not process multiple slides inside one slide agent.
|
||||||
|
- Do not run child sessions or slide agents in parallel.
|
||||||
|
- Do not treat old broad-run images as accepted finals.
|
||||||
|
|
||||||
|
## Suggested Next User Message
|
||||||
|
|
||||||
|
The next user can start with:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Use slide task orchestration for projects/2026-06-23-在路上.
|
||||||
|
|
||||||
|
Task: character consistency test.
|
||||||
|
Worker profile: video-slide-production.
|
||||||
|
Mode: prompt only.
|
||||||
|
Slides: s05, s21, s14, s25, s33.
|
||||||
|
Split: session-01 s05/s21/s14, session-02 s25/s33.
|
||||||
|
|
||||||
|
Create the task records and run session-01 sequentially.
|
||||||
|
```
|
||||||
|
|
||||||
|
If the user wants image generation in the same task, replace `Mode: prompt only` with:
|
||||||
|
|
||||||
|
```text
|
||||||
|
Mode: prompt and generate.
|
||||||
|
```
|
||||||
|
|
||||||
|
## Verification Before Starting
|
||||||
|
|
||||||
|
Before starting the task, verify:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
git status --short
|
||||||
|
Test-Path -LiteralPath 'docs/workflows/slide-task-orchestration.md'
|
||||||
|
Test-Path -LiteralPath 'docs/workflows/slide-task-templates.md'
|
||||||
|
Test-Path -LiteralPath 'projects/2026-06-23-在路上/intake/阶段五-人物一致性单镜.md'
|
||||||
|
Test-Path -LiteralPath 'projects/2026-06-23-在路上/visual-system/style/style-prompt-master.md'
|
||||||
|
Test-Path -LiteralPath 'projects/2026-06-23-在路上/visual-system/characters/character-reference-registry.md'
|
||||||
|
```
|
||||||
Loading…
Reference in New Issue