# Cbi Script

> 使用 CreatiBI CLI（cbi）在专案内创建脚本任务、获取脚本内容、保存脚本内容、上传交付物，并在裂变/衍生场景下管理脚本上下游关系。用户提到”写脚本””保存脚本内容””获取脚本内容””上传交付物””script-save””script-get””script-create””deliverable-upload””脚本任务””交付物”等场景时使用。

- Skill: `creatibi/cbi-script` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add creatibi/cbi-script`
- Raw SKILL.md: https://api.skillmd.com/api/skills/creatibi/cbi-script/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: creatibi (https://skillmd.com/u/creatibi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/creatibi/cbi-script

---


# CreatiBI CLI 脚本写作与保存

聚焦专案脚本读写能力：创建任务、读取脚本、保存脚本、上传交付物，并处理脚本在衍生/裂变链路中的关系。

## 交互规范

- 对用户输出结果与下一步，不展示命令细节。
- 写入前先确认目标对象：`project-id` 或 `script-id`。
- 涉及覆盖或批量关联更新时先确认影响范围。

## 处理顺序

1. 先确认登录状态（依赖 `cbi-shared`）。
2. 创建脚本任务时确认 `project-id` 与任务名称。
3. 保存内容前先获取当前脚本内容（避免误覆盖）。
4. 保存后回读脚本，确认格式和关联信息已生效。

## 能力清单

| 场景 | 处理要点 |
|------|------|
| 创建脚本任务 | `script-create`，支持普通任务/子任务/衍生来源任务 |
| 获取脚本内容 | `script-get`，读取基本信息、关联信息与内容 |
| 保存脚本内容 | `script-save`，支持 JSON/Markdown，支持关联信息更新 |
| 上传交付物 | `deliverable-upload`，上传视频/图片，支持多文件和 MD5 去重 |
| 交付物列表 | `deliverable-list`，查看脚本任务的交付物和附件 |

## 关键规则

- `script-create`：
  - 必填：`project-id`、`name`
  - 可选：`parent-id`（裂变子任务）、`source-object`（衍生来源）
- `script-get`：
  - 必填：`script-id`
  - 可选：`project-id`（权限验证）
- `script-save`：
  - 必填：`script-id`
  - 内容参数二选一或组合更新：`script`（JSON）/`markdown`
  - 可选更新：`name`、`product-ids`、`app-ids`、`ratios`、`ref-repo-file-ids`
  - 格式约束：仅允许普通与剪辑格式（不再使用分镜/口播格式）
- `deliverable-upload`：
  - 必填：`script-id`、`--file`（文件路径，可多次指定）
  - 文件数量限制：1-50 个
  - 第一个文件为主文件，后续为裂变文件（多尺寸变体）
  - 自动 MD5 去重：已存在文件跳过上传
- `deliverable-list`：
  - 必填：`script-id`
  - 可选：`project-id`（权限验证）

## 格式规则

- 格式枚举：`1=普通`、`4=剪辑`。
- 未传 `format` 时按内容自动推导（见 [references/script-format.md](references/script-format.md)）。

## 内部命令骨架

```bash
cbi project script-create --project-id <id> --name "<name>"
cbi project script-get --script-id <id>
cbi project script-save --script-id <id> --script '<json>'
cbi project script-save --script-id <id> --markdown "# 标题"
cbi project deliverable-upload --script-id <id> --file <path> [--file <path>...]
cbi project deliverable-list --script-id <id>
```

## 参考

- [references/script-format.md](references/script-format.md)
- 仓库根目录 `README.md` 的“专案模块 (project)”章节