video-workbench/docs/ccpe-system-handoff.md

5.1 KiB

CCPE System Handoff For Video Workbench

This document is the handoff for future supplier work in:

C:\Users\wangq\Documents\Codex\ccpe-system

It records candidate CCPE assets needed to support Video Workbench. It is not the CCPE consumer interface and must not be used as a formal invocation startup path.

The external CCPE interface is:

C:\Users\wangq\Documents\Codex\ccpe-system\Interface.md

For any CCPE setup or invocation, read Interface.md first, then follow it to:

C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccpe-agent-consumer-setup.md

Do not treat the candidate paths below as canonical invocation paths until a project-local registry resolves a participant to a real canonical_artifact_path.

Core Principle

Use scenario-first layering.

Do not force every old prompt into Skill, Agent, and Runtime layers. Preserve a working Lite kernel when it is the correct production form. Promote to Agent Spec, Skill, Model Card, or Runtime only when the video workflow needs that layer.

Existing Actor To Upgrade

Previous single-agent actor:

强哥的徒弟

Likely first supplier target: a CCPE-owned Lite artifact or Agent Spec for the dimensional-output actor. Do not record a concrete canonical_artifact_path here; that belongs in the project-local registry when a real invocation is prepared.

Purpose:

Transform deep essays and models into public-facing short video plans, scripts, visual prompts, and production packages.

This actor should remain a CCPE-owned local work asset. Video Workbench may request, consume, and validate it, but should not store its canonical prompt or agent definition. Formal use must go through the CCPE interface and project-local registry rules.

  1. Upgrade 强哥的徒弟 into a verified CCPE-Lite artifact.
  2. Validate it through a real Video Workbench project when the user starts one.
  3. Preserve regression tests against the original workflow:
    • angle proposals
    • video outline
    • storyboard logic
    • shot deep production
  4. Run Scenario Probe before promoting to Agent Spec or Skill.
  5. Extract stable embedded models into Model Cards only when they are reusable beyond this actor.
  6. Build small Skills only for repeatable actions:
    • source-to-episode splitter
    • angle proposal generator
    • global visual style builder
    • storyboard logic builder
    • shot deep-production generator
    • image prompt generator
    • voiceover script generator
    • publish copy generator
  7. Build a Short Video Production Runtime only after the core stages are stable.
  8. Validate the runtime with a trial Video Workbench project.

Candidate Asset Map

Asset Candidate Type Purpose
Qiangge's Apprentice CCPE-Lite / Agent Spec Primary dimensional output actor
Dimensional Output Model Model Card Extract deep model into public-facing point
Series Architect Agent / Skill Split long essay/model into episodes
Angle Proposal Generator Skill Produce three distinct entry angles
Tone And Outline Builder Skill Produce video outline and global style
Storyboard Logic Builder Skill Produce shot logic with timing and word budget
Shot Deep Production Skill Produce visual plan, image prompt, voiceover, design notes
Image Prompt Generator Skill Generate consistent image prompts
Voiceover Script Generator Skill Fit narration to duration budget
Short Video Production Runtime Runtime Coordinate full video package production

Runtime Boundary

The first runtime should stop at a production package:

  • selected angle
  • video outline
  • storyboard logic
  • shot deep-production files
  • image prompts
  • voiceover script
  • optional image/audio assets
  • editing notes
  • publishing copy

Do not automate manual editing or platform publishing in the first version.

Relationship To Writing Runtime

Article production and video production should remain separate runtimes.

They share sources and sometimes models, but they differ in:

  • target output
  • audience
  • timing constraints
  • visual constraints
  • asset generation
  • evaluation criteria

Relationship To Deployable Systems

CCPE can design local work agents and can also specify production/business agents for deployable systems. For deployable systems, CCPE owns specifications, boundaries, authority, evaluation, and invocation contracts.

Implementation that depends on LangGraph, CrewAI, server deployment, persistence, monitoring, or product runtime constraints belongs in the target software project, such as a future work-projects repository. Video Workbench remains the local workflow and production-record workspace.

Validation Target

The first validation project should use one existing deep essay and one existing model document from Knowledge Vault.

Expected success:

  • a clear episode or standalone scope
  • three genuinely different angles
  • a selected angle trace
  • a coherent visual/narration protocol
  • a complete storyboard
  • shot-level prompts and voiceover
  • a package ready for manual editing