Skip to content
BranchesTags

Repository files navigation

DIRcreative

A chat-first film preproduction skill for Codex.

把一句创意发展成可讨论、可选择、可验证的导演方案、故事、脚本、镜头、参考图计划与模型专用提示词。

Release CI Python Codex Skill License

快速开始 · 能力 · 交互体验 · 示例 · 文档 · 正式安装

DIRcreative interactive decision surface

DIRcreative 不是“输入一句话、吐出一堆提示词”的黑盒。它先判断任务是局部修改、完整开发还是交付审计，再只加载对应合同。局部任务直接交付修改结果；只有真实方向冲突、生成授权或客户交付才停下来询问。

当前稳定版本为 v0.5.3，包含 v2 路由、动态专业视角、紧凑状态、拆分模型 Adapter、资产基础/压测/生产账本链路和 Specialist Exchange v2。

源码仓库包含 DIRcreative 根 Skill、19 个 skills/dircreative/* 内部子 Skill，以及 ai-film-asset-stress-test、ai-film-production-ledger 两个 P0 能力入口。正式 DIRcreative 安装包按安全设计只暴露根 $dircreative，其余入口会内部化后由 selector 路由；Skill Stack 还会发现宿主中已安装的外部专业 provider。这些依赖不会被复制进本仓库，也不能把“宿主可调用”表述成“GitHub 已内置”。ADCO 始终是独立外部编排方。

Why DIRcreative

  • 先创作，后生成：先解决受众、叙事、产品证明和镜头逻辑，再进入图片或视频生成。
  • 把专业判断放在结果后面：Fast 直接修改；Studio 最多选择三个真正影响结果的专业视角，不展示固定角色会议。
  • 让复杂方案看得懂：方向比较、节奏曲线、镜头时间线、参考图依赖和 QA 结果都可以可视化。
  • 不锁定单一模型：把同一镜头意图适配到 Seedance、Kling、Runway、Veo 等不同生成模型。
  • 证据与风险成比例：Fast / Studio 默认不写路径、Git、receipt 或全项目记录；只有真实生成、交付和跨系统 handoff 才保留必要证据。

What it does

模式 适用任务 默认预算与产出
Fast 一句/一段文案、单镜头、少量分镜、Prompt 或既有产物局部修改 <= 14 KB 上下文、0 Threads、0 Director Room；>= 75% 有用内容
Studio 完整概念、故事+脚本、脚本+分镜、多产物影视前期 <= 20 KB 上下文、最多 3 个动态专业视角、最多 1 个 critic；>= 70% 有用内容
Delivery 真实生成授权、正式版本/资产、客户可见交付、有效 ADCO handoff <= 30 KB 上下文；只为当前真实动作运行审计与 receipt 
explicit $dircreative → direct judgment → Fast | Studio | Delivery
                     → one Route Card + at most one craft card
                     → useful artifact first
                     → router only for ambiguity or validated handoff

Visual, conversational workflow

可视化不是装饰，而是每个用户决策的操作界面：

  • 方案比较卡：选中项、推荐理由和下游影响同步变化，避免“选择变了、建议没变”。
  • 曲线与时间线：展示情绪、信息密度、钩子、产品曝光和镜头节奏。
  • 关系图：说明角色、场景、产品、参考图和最终镜头之间的继承关系。
  • 图片审阅：在对话中查看候选图、放大关键区域、标记问题，并决定采用、重试或改方向。
  • 明确空状态：没有媒体时显示生成前置条件与下一步，不使用假图冒充结果。
  • 响应式布局：桌面端并排比较，窄屏自动改为可读的纵向流程。

2026-07-14 对 v0.4.0 交互面的本地浏览器验收覆盖 14 个页面、84 个响应式场景、0 个失败；复现命令见 Development and validation。技术门禁证明界面和工作流按约定运行，但不会替代具体客户项目的真人创意验收。

Quick start

Prerequisites

  • 支持 Skills 的 Codex 环境
  • Python 3.10+
  • Ruby（项目总验证中的 YAML 兼容检查需要）
  • 可选：Node.js 20+ 与 Playwright，仅用于 84 场景浏览器审计
  • 可选：GitHub CLI gh，仅用于下载正式 Release

1. Clone and install a development copy

git clone https://github.com/papperrollinggery/Paperrolling-DIRcreative-SKILL.git
cd Paperrolling-DIRcreative-SKILL
python3 scripts/install_local_skill.py

开发副本安装到 ~/.codex/dev-skills/dircreative，不会覆盖正式 SkillHub 安装。

2. Run the demo and validation

PYTHONDONTWRITEBYTECODE=1 python3 scripts/dircreative_headless_acceptance_audit.py
PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_project.py

安装后请打开一个新的 Codex 任务，并显式写 $dircreative。隐式调用已关闭；普通广告问题或仓库维护不会启动本 Skill。

3. Start in Codex

可以直接用自然语言开始：

$dircreative 把“多年未见的朋友，因为一件旧物重新联系”
发展成一支 30 秒品牌短片。先给我推荐方向和首轮故事，不生成图片或视频。

DIRcreative 会选择 Fast、Studio 或 Delivery。Fast 不进入 Director Room；Studio 只选择能改变结果的 narrative_strategy、visual_production、model_continuity 视角，最多三个。用户不需要点名固定角色。

Safety model

  • 未获得用户明确授权，不直接生成图片或视频。
  • 完整成片先展示动态视觉资产矩阵：角色/产品/关键道具、每个场景、每个镜头的独立分镜图、覆盖全部镜头的导演故事板，以及模型实际需要的 clean frames。
  • TVC 验收使用 16:9 广播主档案，不以 9:16 社媒变体代替；具体帧率、声音、字幕/法务安全区与母版参数以目标客户或播出方规格为准。
  • 再展示生成合同：每张图的用途、继承来源、标题层级和是否会成为视频输入；代表性样片不得冒充全片完成。
  • 视觉资产计划 v2.2 绑定源清单、批准 shot cards、连续且逐帧对齐的 timecode、完整逐镜创意真相和精确继承关系；完成证据统一为依赖无关的规范 PNG，场景、逐镜、风格与视频输入帧必须匹配目标画幅，文件完整解码后再绑定规范化像素身份、技术收据和包内独立视觉复核清单。user_locked 只是工作流状态，不能绕过复核；技术盖章不能自动通过视觉判断，独立资产也不得靠 metadata 改写把同一画面冒充多张图。
  • visual_assets_complete 只表示场景图、逐镜分镜、导演故事板和视频输入帧完成，不表示 TVC 成片、客户批准或电视台验收。
  • fixture、终端演示、HTML 页面和自动化测试不能冒充真人验收。
  • 生成候选、临时截图和 review widget 不能自动成为项目 source of truth。
  • 不在未授权情况下修改目标项目的 AGENTS.md。

ADCO Integration

DIRcreative 既可以独立在聊天中运行，也可以作为 ADCO 的影视前期专业 worker：

protocol_id: adco.specialist-exchange
contract_version: "2.0"
execution_mode: inline

ADCO 负责客户交互、Current Truth、采用决策、版本、可见性、PPT、FinalDelivery、完成状态和 cleanup；DIRcreative v2 只返回领域产物、领域 QA、状态和开放问题，不复制这些控制平面字段。v1 handoff/receipt/adoption 仍可读取。

python3 scripts/dircreative_adco_native_exchange.py --self-test
python3 scripts/dircreative_adco_native_exchange.py \
  --adco-repo /path/to/ad-creative-orchestrator

未提供 --adco-repo 时，发布门只报告 RELEASE_GATE_SCOPE: DIR_ONLY，不能作为双边兼容证据。完整协议见 adco-integration-contract.md。

Examples

示例 适合查看
live-user-sim-noodle 从一句产品创意到方向、脚本、镜头、参考图与模型提示词的完整对话
cyber-courier Director Room 如何形成并选择概念方向
goal-mode-simulation-test 用户不逐项回复时，如何标注模拟选择并安全继续
assisted-generation-preflight-chat 用户说“看看图”时，如何先完成生成前置门
zombie-cleaner-test 180 秒长叙事的拆解、参考计划与 prompt-only 测试

Documentation

完整规范、schemas、研究与运行手册位于 docs/film-preproduction。

Verified release install

正式安装源是同一 GitHub Release 中的归档和 SHA256SUMS，再由该 tag 的精确、 干净源码执行同进程验证与安装；不能运行归档内的 installer，也不能用 metadata 自证。下面的信任链从 v0.5.0 起适用；更早版本不满足这条正式安装门。

gh release download v0.5.3 \
  --repo papperrollinggery/Paperrolling-DIRcreative-SKILL \
  --pattern 'dircreative-0.5.3.tar.gz' \
  --pattern 'SHA256SUMS'
从精确 tag 一次完成验证、可复现重建、安装和回读 
set -euo pipefail
REPO_URL="https://github.com/papperrollinggery/Paperrolling-DIRcreative-SKILL.git"
TAG="v0.5.3"
EXPECTED_COMMIT="$(
  git ls-remote --exit-code --tags "$REPO_URL" \
    "refs/tags/$TAG" "refs/tags/$TAG^{}" |
  awk -v ref="refs/tags/$TAG^{}" '
    $2 == ref { count += 1; sha = $1 }
    END {
      if (count != 1 || length(sha) != 40 || sha !~ /^[0-9a-f]+$/) exit 1
      print sha
    }
  '
)"
ARTIFACT="$(pwd)/dircreative-0.5.3.tar.gz"
CHECKSUMS="$(pwd)/SHA256SUMS"
VERIFY_ROOT="$(mktemp -d)"
trap 'rm -rf "$VERIFY_ROOT"' EXIT
git clone --filter=blob:none --no-checkout "$REPO_URL" "$VERIFY_ROOT/source"
git -C "$VERIFY_ROOT/source" fetch --depth 1 origin \
  "refs/tags/$TAG:refs/tags/$TAG"
git -C "$VERIFY_ROOT/source" checkout --detach "$EXPECTED_COMMIT"
python3 "$VERIFY_ROOT/source/scripts/install_local_skill.py" \
  --target ~/.skillshub/dircreative \
  --formal-install \
  --artifact "$ARTIFACT" \
  --checksums "$CHECKSUMS" \
  --expected-commit "$EXPECTED_COMMIT" \
  --expected-tag "$TAG" \
  --reproducible-source "$VERIFY_ROOT/source"

维护者安装未发布的精确候选时仍需完整 artifact/checksum/source 绑定，并额外显式 加入 --allow-unpublished。它只放宽 canonical remote tag 条件；exact commit、干净 canonical source、逐字节可复现、完整 manifest、staging 与 target 回读都不会放宽。

安装后验证实际目标：

cd ~/.skillshub/dircreative
python3 scripts/validate_project.py
python3 scripts/dircreative_adco_native_exchange.py --self-test

Development and validation

最常用的本地门禁：

python3 scripts/validate_project.py
python3 scripts/dircreative_activation_policy_audit.py
python3 scripts/dircreative_context_budget_audit.py
python3 scripts/dircreative_director_harness_audit.py
python3 scripts/dircreative_prompt_fixture_audit.py
python3 scripts/dircreative_headless_acceptance_audit.py
python3 scripts/dircreative_content_first_audit.py
python3 scripts/dircreative_live_model_eval.py --self-test
python3 scripts/dircreative_visual_asset_plan.py --self-test
python3 scripts/dircreative_readiness_audit.py
python3 scripts/dircreative_quality_audit.py
python3 scripts/dircreative_chat_surface_audit.py
python3 scripts/dircreative_visualization_dogfood.py
python3 scripts/dircreative_adco_native_exchange.py --self-test

dircreative_live_model_eval.py 只验证真实模型的文字响应行为，不证明图片或 视频已经生成。当正式安装验收包含真实媒体能力时，需针对仓库内候选执行一次 隔离的交互式媒体前向测试，检查实际落盘文件；测试媒体保留在仓库包之外。 媒体收据不能只自报 real_tool_execution=true。v2 前向测试用两份相互绑定的 收据：执行收据必须绑定 Codex 原始 JSONL 日志的不可变前缀（字节数与 SHA-256）， 从真实日志反推出独立任务中的密封 $dircreative 用户调用、候选 Skill 观察、 imagegen 事件 ID、提示词、按序参考图、输出字节与时间；另一独立任务的日志必须绑定 只含原始参考图、输出和 rubric 的密封审查请求，证明每个输出恰好打开一次，并绑定其 审查结论。门禁会 把固定哈希的 c2patool 复制到私有快照后，再校验 OpenAI Media Service 的 C2PA 签名、签发 CA、gpt-image 2.0 创建声明、签名时间和输出 数据哈希。C2PA 不绑定提示词或输入参考；本机日志仍是 unsigned host trace， 视觉结论仅是 reviewer judgment，图片通过也不代表视频已经验证。

完整发布门：

python3 scripts/dircreative_release_gate.py \
  --require-tag \
  --adco-repo /path/to/ad-creative-orchestrator \
  --media-forward-receipt /absolute/path/to/media-forward-execution-v2.json \
  --media-review-receipt /absolute/path/to/media-visual-review-v1.json \
  --media-host-event-log /absolute/path/to/execution-rollout.jsonl \
  --media-review-host-event-log /absolute/path/to/review-rollout.jsonl \
  --media-c2patool /absolute/path/to/pinned/c2patool \
  --require-media-forward

--allow-unpublished 仅用于开发或 CI 预发布检查，不是正式 release 证据。发布门在开始时封存一个精确 commit，把同一 SHA 传给媒体、preflight、build 与 archive verifier，并在结束时再次读取 HEAD；任何中途切换都会失败。它还验证源码、行为、临时安装、独立校验归档和可选的 ADCO 双边兼容。

复现完整浏览器响应式审计：

npm ci
npx playwright install chromium
python3 scripts/dircreative_visualization_dogfood.py
npm run audit:visual-browser

审计覆盖 736px / 320px、明暗主题、文字间距和大字号模式，并检查横向溢出、文字重叠、裁切、触控目标、图片状态、选择后的推荐同步和可执行动作。

Contributing

欢迎通过 Issues 报告问题或提出改进。提交前请：

  1. 保持修改范围集中，不把 fixture 结果写成真人验收。
  2. 为 bug 补最小复现或回归测试。
  3. 运行 python3 scripts/validate_project.py 和与改动相关的审计脚本。
  4. 不提交客户素材、密钥、真实运行历史或个人绝对路径。

Issue 与 PRD 约定见 docs/agents/issue-tracker.md。

Fixture media notice

outputs/reference-pack/ 中的图片是用于测试参考图绑定与审阅流程的 AI-generated fixtures。仓库公开或标记为 project_owned 仅描述 fixture 在测试中的归属关系，不授予素材商用权，也不替代对具体模型条款、品牌权利和投放地区的独立审核。

License

This repository is publicly readable, but no open-source license has been granted yet. Until a license is added, default copyright restrictions apply.

本仓库目前可公开阅读，但尚未授予开源许可证。在正式添加许可证之前，默认著作权限制仍然适用。

About

Chat-first film preproduction skill for Codex: director-room ideation, story/script/shot design, visual review, model-specific prompts, and verified releases.

github.com/papperrollinggery/Paperrolling-DIRcreative-SKILL/releases/latest

Topics

advertisingagent-skillsai-agentscodexcreative-aicreative-workflowdirectorfilm-preproductionfilmmakinggenerative-aiimage-generationmulti-agentprompt-engineeringstoryboardingvideo-generation

Resources

Readme
Activity

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages