AIGC-Director Agent 技能

本地运行：这是一个本地部署的视频生成项目，前后端都运行在本机：

• - 后端：http://localhost:8000
• 前端：http://localhost:3000
• 所有 API 调用都请求本地服务器，不要请求其他地址！
• 确保在调用任何 API 之前，后端和前端服务都已经启动并运行正常！

核心理念：Agent 应该像持续陪伴的智能视频制作助理，每完成一个用户可感知的重要任务，都应立即给用户一条简报，并等待用户确认。

核心原则：每个阶段的产物都必须展示给用户，必须停下来等待用户确认后才能继续下一阶段。

防止遗忘：在整个流程中，Agent 可能会忘记之前的用户输入或之前阶段的产物内容。每当进入一个新的阶段时，Agent 都必须重新加载这篇SKILL文档，确保不会忘记任何细节。

项目结构

aigc-director/ ← OpenClaw 调用的 skill 根目录
├── aigc-claw/ ← 前后端项目代码
│ ├── backend/ ← FastAPI 后端（端口 8000）
│ │ └── code/result/ ← 模型生成产物存放目录
│ │ ├── script/ ← 剧本产物
│ │ ├── image/ ← 图片产物（角色、场景、参考图）
│ │ └── video/ ← 视频产物
│ └── frontend/ ← Next.js 前端（端口 3000）
├── references/ ← OpenClaw 调用时的参考文档
│ ├── init_project/ ← 项目初始化
│ ├── run_project/ ← 服务启动
│ ├── workflow/ ← 六阶段工作流 API
│ ├── sandbox/ ← 临时工作台 API
│ └── send_message/ ← 消息发送
└── SKILL.md ← skill 正文

产物存放目录：aigc-claw/backend/code/result/

• - script/ - 剧本产物
• image/ - 图片产物（角色、场景、参考图）
• video/ - 视频产物

阶段与停点（共9个）

注意：suggestexpand 和 loglineselection 可能根据输入质量被跳过。

工作流程

1. 本地部署(仅初始化时执行)

当用户要求初始化项目、配置项目、部署项目时，需要先进行项目初始化：参考 initall.md 执行完整初始化流程。

注意：仅在用户首次下载项目或需要重新配置环境时使用。项目已初始化过则跳过此步骤，直接检查服务运行状态。

2. 检查本地服务

参考 startbackend.md 和 startfrontend.md 检查服务是否运行。

⚠️ 强制要求：如果服务未运行，必须先启动服务再继续！

2. 路由判断

3. 执行流程

1. 1. 检查后端运行状态 → 未运行则参考 startbackend.md 启动 → 等待3秒 → 再次检查
2. 检查前端运行状态 → 未运行则参考 startfrontend.md 启动 → 等待5秒 → 再次检查
3. 检查 API Key 配置 → 读取 .env 文件，确认所需 API Key 已配置
4. 参考 createproject.md 询问用户项目配置 → 停点1（配置确认）→ 创建项目
5. 参考 createscript.md 执行剧本生成 → 停点2-5
6. 参考 createcharacter.md 执行角色设计 → 停点6
7. 参考 createstoryboard.md 执行分镜设计 → 停点7
8. 参考 createreference.md 执行参考图生成 → 停点8
9. 参考 createvideo.md 执行视频生成 → 停点9
10. 参考 create_post.md 执行后期剪辑
11. 完成 → 发送最终视频给用户

注意：一定要参考 references/ 目录下的具体文档执行每一步操作，不要凭记忆或想当然去调用 API！

检查 API Key 配置

在创建项目前，必须检查用户选择的模型对应的 API Key 是否已配置：

bash

读取 .env 文件检查配置

必需的配置（根据选择的模型）

LLM: DASHSCOPEAPIKEY / DEEPSEEKAPIKEY / OPENAIAPIKEY / GEMINIAPIKEY

图片: ARKAPIKEY / DASHSCOPEAPIKEY

视频: DASHSCOPEAPIKEY / VOLCACCESSKEY / KLINGACCESSKEY

如果 API Key 未配置，需要提醒用户：

1. 1. 告知缺少哪个平台的 API Key
2. 提供获取方式
3. 配置位置（aigc-claw/backend/.env 文件）
4. 等待用户配置完成后才能继续

🚨 停点处理（强制规则）

当查询状态为 stagecompleted 或 waitingin_stage 时，必须按以下步骤执行：

步骤1：获取产物

步骤2：展示给用户

步骤3：询问决策

• - 选项有哪些
• 每个选项的含义
• 需要用户选择什么

步骤4：等待用户回复

步骤5：用户确认后执行

❌ 错误示例（我刚才犯的错）

收到 suggest_expand 停点 → 直接调用 intervene → 跳过用户确认

✅ 正确示例

1. 1. 阶段内部停点触发（如 suggest_expand）

1. 2. 阶段完成停点触发