creative-ops-copilot

将凌乱的客户简报转变为动效设计/视觉特效项目的生产就绪计划：范围、假设/排除、可交付成果矩阵、时间表/里程碑、审查轮次和估算/报价。还为 Chris 的本地发票系统 (invoicing_system_2025) 生成发票草稿有效负载或导出报价/发票 JSON/CSV/Markdown。当 Chris 要求从简短/电子邮件注释/聊天日志转为清晰的计划 + 报价/发票，或创建可重复的项目文件夹 + 文档时使用。

# Creative Ops Copilot

## What to do

1) Ask for (or infer) the input brief:
- Paste text directly, or
- Provide a file path to a brief/email/thread export.

2) Produce these outputs (always):
- `docs/creative-ops/plan.md` (client-ready)
- `docs/creative-ops/estimate.json` (structured line items)
- `docs/creative-ops/invoice-draft.json` (ready for API import later)

3) If Chris wants it, also:
- Create a project folder skeleton (AE/C4D/Octane-friendly) with a `docs/README.md`.
- POST the invoice draft to the local invoicing API (only if base URL is configured and Chris says “push it”).

## Canonical output structure (plan.md)

- Project summary (one paragraph)
- Goals / Success criteria
- Deliverables (matrix)
  - Format, duration, aspect ratios, versions, audio deliverables
- Workflow assumptions
  - what’s included, what’s not, number of review rounds
- Open questions (what you still need answered)
- Production plan
  - phases + milestones + review windows
- Risks / dependencies
- Estimate
  - line items + hours + rate + subtotal + contingency
- Next actions

## How to generate reliably

Prefer generating structured data first, then render it:

1) Extract entities
- Client name
- Project name
- Deadline/date constraints
- Deliverables list
- Constraints (brand, legal, footage supply, approvals)

2) Decide the production approach
- Template-driven vs bespoke
- 2D AE vs 3D C4D vs mixed

3) Estimate with motion/VFX realism
- Prepro (briefing, styleframes, boards)
- Production (anim, 3D, comp)
- Audio/music/licensing (if applicable)
- Renders, exports, versioning
- PM/admin buffer

## Scripts (recommended)

Use the bundled script to create consistent outputs:

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief "<paste brief>" --out .
```

If the brief is a file:

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief-file "C:\path\to\brief.txt" --out .
```

To also create a project skeleton:

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief "..." --out . --skeleton
```

To attempt pushing the invoice draft to your local invoicing API (only if configured):

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief "..." --out . --push-invoice
```

## Configuration

Optional config file:
- `skills/creative-ops-copilot/references/config.example.json`

Copy to:
- `skills/creative-ops-copilot/references/config.json`

Then edit:
- `invoicingApi.baseUrl`
- `invoicingApi.apiKey` (if needed)
- `rateCard` defaults

## Notes

- Keep outputs concise, clean, and client-ready.
- When anything is missing/ambiguous, surface it under **Open questions** instead of guessing.

---

## 中文说明

# Creative Ops Copilot

## 要做什么

1) 索取（或推断）输入简报：
- 直接粘贴文本，或
- 提供简报/电子邮件/聊天记录导出文件的路径。

2) 产出以下输出（始终生成）：
- `docs/creative-ops/plan.md`（可直接交付客户）
- `docs/creative-ops/estimate.json`（结构化的报价行项）
- `docs/creative-ops/invoice-draft.json`（便于后续通过 API 导入）

3) 如果 Chris 需要，还可以：
- 创建一个项目文件夹骨架（适配 AE/C4D/Octane），并附带 `docs/README.md`。
- 将发票草稿 POST 到本地发票 API（仅当配置了 base URL 且 Chris 明确说“push it”时）。

## 标准输出结构（plan.md）

- 项目摘要（一段话）
- 目标 / 成功标准
- 可交付成果（矩阵）
  - 格式、时长、画面比例、版本、音频交付物
- 工作流假设
  - 包含什么、不包含什么、审查轮次数量
- 待解决问题（你仍需获得答复的事项）
- 制作计划
  - 阶段 + 里程碑 + 审查窗口
- 风险 / 依赖
- 估算
  - 行项 + 工时 + 费率 + 小计 + 应急预留
- 后续动作

## 如何稳定地生成

优先先生成结构化数据，再进行渲染：

1) 提取实体
- 客户名称
- 项目名称
- 截止日期/日期约束
- 可交付成果清单
- 约束条件（品牌、法律、素材供给、审批）

2) 确定制作方式
- 模板驱动 vs 定制
- 2D AE vs 3D C4D vs 混合

3) 以动效/视觉特效的真实成本进行估算
- 前期（简报、风格帧、分镜）
- 制作（动画、3D、合成）
- 音频/音乐/授权（如适用）
- 渲染、导出、版本管理
- 项目管理/行政缓冲

## 脚本（推荐）

使用随附脚本以生成一致的输出：

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief "<paste brief>" --out .
```

如果简报是一个文件：

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief-file "C:\path\to\brief.txt" --out .
```

同时创建项目骨架：

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief "..." --out . --skeleton
```

尝试将发票草稿 push 到本地发票 API（仅当已配置时）：

```powershell
python skills/creative-ops-copilot/scripts/creative_ops_copilot.py --brief "..." --out . --push-invoice
```

## 配置

可选配置文件：
- `skills/creative-ops-copilot/references/config.example.json`

复制为：
- `skills/creative-ops-copilot/references/config.json`

然后编辑：
- `invoicingApi.baseUrl`
- `invoicingApi.apiKey`（如需要）
- `rateCard` 默认值

## 注意事项

- 保持输出简洁、整洁、可直接交付客户。
- 当任何信息缺失/含糊时，将其列在 **Open questions** 下，而非凭空猜测。