CLAUDE.md

# 角色

短视频孵化专家，使用 video-from-script 技能体系制作短视频和账号。

# 路由

| 用户意图 | 技能 |
|---------|------|
| 生图、批量出图、MJ、Gemini | `image-generator` |
| 成片、组装、剪映、图片轮播 | `capcut` |
| 做视频、图文成片、图生视频、首尾帧 | `video-from-script` |
| 创建账号、新账号 | 参考 [account-creation.md](.claude/skills/video-from-script/references/account-creation.md) |

# 工作流

所有执行细节按 [SKILL.md](.claude/skills/video-from-script/SKILL.md) 执行。

核心步骤：**意图确认 → 风格校验 → 分镜规划(shotDesc/directorRef) → 图片提示词 → 生图+人工确认硬卡点 → 视频提示词 → 上传+生视频 → TTS+成片**

每步必须经过用户确认或质量卡点才能进入下一步。

# 账号

账号配置在 [accounts/](accounts/) 目录（项目根目录），每个子目录一个账号，含 `account.json`。Agent 需要账号信息时扫描该目录获取最新列表，不依赖本文档的记忆。

# 常用操作

| 用户意图 | 操作 |
|---------|------|
| 重新生成草稿、重做草稿、草稿再生 | 1. 将 manifest 中 `pipeline.phases.assemble` 改为 `"pending"`；2. 执行 `node .claude/skills/video-from-script/scripts/pipeline.js run --manifest output/{name}/manifest.json --phase assemble` |
| 查看草稿进度、草稿状态 | `node .claude/skills/video-from-script/scripts/pipeline.js status --manifest output/{name}/manifest.json` |
| 重跑某个阶段 | 将 manifest 中对应 phase 改为 `"pending"`，再跑 `--phase <阶段名>`。阶段: `images` → `upload` → `videos` → `tts` → `assemble` |

**草稿 = CapCut 剪映项目文件**，由 pipeline 的 `assemble` 阶段生成，输出到本地剪映目录。

# 参考文档

- [SKILL.md](.claude/skills/video-from-script/SKILL.md) — 主技能（强制规则、分镜规则、质量卡点、执行策略）
- [account-system.md](.claude/skills/video-from-script/references/account-system.md) — 账号规范
- [account-creation.md](.claude/skills/video-from-script/references/account-creation.md) — 账号创建 Q&A 流程
- [manifest-schema.md](.claude/skills/video-from-script/references/manifest-schema.md) — manifest 字段规范
-												init: video-create project with skills and accounts

											
										
										
											2026-04-29 21:04:43 +08:00
+								# 角色
 								短视频孵化专家，使用 video-from-script 技能体系制作短视频和账号。
 								# 路由
 								| 用户意图 | 技能 |
 								|---------|------|
 								| 生图、批量出图、MJ、Gemini | `image-generator` |
 								| 成片、组装、剪映、图片轮播 | `capcut` |
 								| 做视频、图文成片、图生视频、首尾帧 | `video-from-script` |
-												feat(video-from-script): 新增账号创建Q&A流程并移除独立风格文件系统

- 新增 `account-creation.md` 参考文档，定义结构化问答创建账号流程
- 将视觉风格信息内嵌到 `prompts/*.md` 中，移除独立的 `styles/` 目录
- 更新 SKILL.md 和 account-system.md 以反映新架构
- 更新账号校验逻辑适配新参考图管理方式
- 更新模板 `account.json` 添加 `references` 字段和默认视频模型

											
										
										
											2026-04-30 21:27:49 +08:00
+								| 创建账号、新账号 | 参考 [account-creation.md](.claude/skills/video-from-script/references/account-creation.md) |
-												init: video-create project with skills and accounts

											
										
										
											2026-04-29 21:04:43 +08:00
 								# 工作流
 								所有执行细节按 [SKILL.md](.claude/skills/video-from-script/SKILL.md) 执行。
-												feat(video-from-script): 重构工作流为子Agent分步执行并新增提示词模板系统

将视频制作工作流拆分为独立子步骤：分镜 → 图片提示词 → 生图 → 视频提示词 → 生视频 → 成片，每步由子Agent独立执行。引入prompts/目录统一管理提示词模板（分镜.md、图片提示词.md、视频提示词.md），通过account.json的storyboardPrompt/imageStylePrompt/videoStylePrompt字段引用。

变更内容：
- 新增confirmed机制和pipeline.js confirm命令，生图后必须人工确认才能继续
- manifest schema改用shotDesc/narration/duration/directorRef替代旧字段
- 文件命名规则从keyword改为slug（从shotDesc/narration派生）
- 删除旧的storyboard-rules.md和prompt-rules.md
- pipeline.js脚本拆分为lib/目录下的独立模块（cmd-init/cmd-confirm/cmd-validate/phase-*）
- 新增cmd-create-account支持一键创建带prompts目录的账号
- capcut_assemble支持narration字段替代text作为字幕源
- 新增.gitclaude/settings.json权限配置

											
										
										
											2026-04-30 21:18:31 +08:00
+								核心步骤：**意图确认 → 风格校验 → 分镜规划(shotDesc/directorRef) → 图片提示词 → 生图+人工确认硬卡点 → 视频提示词 → 上传+生视频 → TTS+成片**
-												init: video-create project with skills and accounts

											
										
										
											2026-04-29 21:04:43 +08:00
 								每步必须经过用户确认或质量卡点才能进入下一步。
 								# 账号
-												chore: 移除旧的 `.claude/settings.json` 权限配置并将账号目录迁移到项目根目录

- 删除 `.claude/settings.json` 中的大量 `Bash` 和 `Edit` 权限许可
- 将 `accounts/` 目录从技能脚本子目录迁移到项目根目录
- 更新所有技能文档和脚本中引用 `accounts/` 的路径为项目根目录
- 移除 `forbidden-emperor` 账号中多余的中文提示词配置文件

											
										
										
											2026-04-30 01:31:13 +08:00
+								账号配置在 [accounts/](accounts/) 目录（项目根目录），每个子目录一个账号，含 `account.json`。Agent 需要账号信息时扫描该目录获取最新列表，不依赖本文档的记忆。
-												init: video-create project with skills and accounts

											
										
										
											2026-04-29 21:04:43 +08:00
-												docs(project): 添加常用操作文档说明

在 CLAUDE.md 中新增"常用操作"表格，记录草稿再生、查看状态和重跑阶段等常见工作流操作步骤。

											
										
										
											2026-05-01 20:35:27 +08:00
+								# 常用操作
 								| 用户意图 | 操作 |
 								|---------|------|
 								| 重新生成草稿、重做草稿、草稿再生 | 1. 将 manifest 中 `pipeline.phases.assemble` 改为 `"pending"`；2. 执行 `node .claude/skills/video-from-script/scripts/pipeline.js run --manifest output/{name}/manifest.json --phase assemble` |
 								| 查看草稿进度、草稿状态 | `node .claude/skills/video-from-script/scripts/pipeline.js status --manifest output/{name}/manifest.json` |
 								| 重跑某个阶段 | 将 manifest 中对应 phase 改为 `"pending"`，再跑 `--phase <阶段名>`。阶段: `images` → `upload` → `videos` → `tts` → `assemble` |
 								**草稿 = CapCut 剪映项目文件**，由 pipeline 的 `assemble` 阶段生成，输出到本地剪映目录。
-												init: video-create project with skills and accounts

											
										
										
											2026-04-29 21:04:43 +08:00
+								# 参考文档
 								- [SKILL.md](.claude/skills/video-from-script/SKILL.md) — 主技能（强制规则、分镜规则、质量卡点、执行策略）
 								- [account-system.md](.claude/skills/video-from-script/references/account-system.md) — 账号规范
-												feat(video-from-script): 新增账号创建Q&A流程并移除独立风格文件系统

- 新增 `account-creation.md` 参考文档，定义结构化问答创建账号流程
- 将视觉风格信息内嵌到 `prompts/*.md` 中，移除独立的 `styles/` 目录
- 更新 SKILL.md 和 account-system.md 以反映新架构
- 更新账号校验逻辑适配新参考图管理方式
- 更新模板 `account.json` 添加 `references` 字段和默认视频模型

											
										
										
											2026-04-30 21:27:49 +08:00
+								- [account-creation.md](.claude/skills/video-from-script/references/account-creation.md) — 账号创建 Q&A 流程
-												init: video-create project with skills and accounts

											
										
										
											2026-04-29 21:04:43 +08:00
+								- [manifest-schema.md](.claude/skills/video-from-script/references/manifest-schema.md) — manifest 字段规范