互动游戏颗粒生产与研发工作室

多 Agent 协作的互动教学颗粒生产与研发流水线。

输入：一句话教学需求（如"帮我做一个小学三年级分数初步认识的教学颗粒"） 输出：可执行的互动教学脚本（BranchVideo V3 格式，可导入平台播放）

---

体系架构原则

Agent 与 Skill 的分工

层面	归属	内容	示例
身份	Agent	角色名称、定位、人设	"你是颗粒生产系统的游戏编剧"
职责	Agent	负责什么、不负责什么	"产出剧本节目单，不直接写文件"
协作接口	Agent	上游是谁、下游是谁	"从项目经理接收项目文件，输出给美术总监"
交互行为	Agent	如何回复用户、确认话术、展示格式	"✅ 剧本节目单已完成！请确认是否继续"
专业建议	Agent	基于角色专业背景主动给出建议	"建议将地核温度表述改为'约5000°C'更科学"
工作策略	Agent	设计原则、优先级、决策倾向	"风格统一优先、功能性优先"
执行规则	Skill	怎么做、格式、校验、禁止	"节点 ID 必须为 Sxx.x 格式"
输出格式	Skill	模板、字段、枚举值	"方案 ID 格式：方案 ID（方案名称）"
能力边界	Skill	能做什么、不能做什么	"进入时触发仅支持：数值变更/获得道具/学伴反馈"

核心原则：Skill 是强制规则，Agent 是角色入口

• Agent 文件中定义：身份、职责、协作接口、交互行为、专业建议能力、工作策略
• 所有格式、规则、校验、禁止行为必须定义在 Skill 中
• Agent 执行时必须读取并严格遵守对应 Skill 的定义
• 禁止在 Agent 文件中定义输出格式、校验规则、字段枚举值

唯一真相源

每个领域的规则有且只有一个 Skill 定义，不重复、不冲突：

领域	唯一真相源 Skill
项目文件结构、验收标准	skills/项目生产管理
节点 ID、分支跳转、系统红线	skills/互动游戏系统
剧本写作技巧、叙事框架	skills/互动游戏编剧
方案配置、Prompt 规范	skills/互动游戏方案库
艺术风格选项、提示词模板	skills/艺术风格
世界观 IP 设定	skills/世界观 IP
任务拆解、状态管理	skills/资源制作管理
文件命名、目录结构	skills/项目生产管理（本章）

LLM 约束机制

Skill 是程序化规则，不是"参考建议"。约束方式：

1. 格式模板：提供完整的 Markdown 模板，Agent 必须按模板填空
2. 枚举值校验：明确列出所有可选值（如方案 ID、艺术风格），禁止自创
3. 正则约束：对 ID 格式等定义正则表达式（如 S\d{2}\.\d+）
4. 禁止清单：明确列出禁止行为，违反即为不合格
5. 必填字段：标记哪些字段必填、哪些选填、哪些条件必填
6. 能力边界：明确字段允许的取值范围，超出即为非法

Agent 专业建议能力

每个 Agent 不仅是执行者，还是该领域的专业顾问。当用户提出需求或修改意见时，Agent 应当：

1. 判断合理性：基于专业知识和 Skill 规范，判断用户需求的合理性
2. 主动建议：发现潜在问题时，主动提出更优方案
3. 解释原因：给出建议时说明原因，而非只说"不行"
4. 尊重决策：最终决策权在用户，建议后仍需执行用户的选择

示例场景：

• 用户要求"把地核温度写为 10000°C"→ 游戏编剧应建议"科学表述为约 5000°C，和太阳表面一样热"
• 用户要求"加 20 个互动节点"→ 美术总监应建议"资源制作量过大，建议先做 5 个核心节点验证"
• 用户要求"用 3D 写实风格做小学三年级内容"→ 项目经理应建议"3D 卡通更适合低龄段，3D 写实偏严肃"
• 用户要求修改 Agent/Skill → 项目经理应评估影响范围，建议先在测试项目验证再全量

---

文件命名规范

项目文件（3 个，不多不少）

每个项目只能生成以下 3 个文件，位于 workspace/projects/ 目录：

文件	命名格式	说明
项目生产详情	#{任务ID}-{剧本标题}-{知识点名称}-项目生产详情.md	主文件，含需求、设计、剧本、资产、脚本
报告与日志	#{任务ID}-{剧本标题}-{知识点名称}-报告与日志.md	用户调研报告 + 项目经理验收报告 + 生产问题与建议 + 生产日志
颗粒脚本	#{任务ID}-{剧本标题}-{知识点名称}-script.json	脚本总装产出的 V3 JSON 文件

命名规则：

• 任务 ID：6 位数字，从 #100001 开始递增
• 剧本标题：格式为 [剧本主标题]：[知识点名称]，如 地球探险号：地球三层结构探秘
• 知识点名称：从结构化需求中提取，如 地球三层结构探秘
• 分隔符：使用 - 连接各部分，不使用空格
• 中文冒号：剧本标题中的 ： 为中文全角冒号

禁止行为：

• ❌ 擅自创建第 4 个文件（如独立的调研报告、配置存档等）
• ❌ 使用与命名规则不一致的文件名
• ❌ 使用英文冒号 : 或下划线 _ 替代中文冒号 ：
• ❌ 使用旧格式（如 100001-branch-video-v3-script.json）

两阶段文件命名

阶段	时机	文件名
阶段 1	需求结构化后	#{任务ID}-{知识点名称}-项目生产详情.md（先用知识点名称占位）
阶段 2	剧本节目单验收通过后	重命名为 #{任务ID}-{剧本标题}-{知识点名称}-项目生产详情.md

阶段 2 重命名操作（项目经理必做）：

1. 游戏编剧产出验收通过后
2. 从剧本节目单的"基础信息"中提取"剧本标题"
3. 验证剧本标题格式为 [剧本主标题]：[知识点名称]
4. 执行文件重命名（mv 命令）
5. 同时更新项目文件内部标题（# #{任务ID} {剧本标题} - 项目生产详情）
6. 在"生产问题与建议"中记录重命名操作

---

项目文件内部结构

项目生产详情文件

# #{任务ID} {剧本标题} - 项目生产详情

**任务 ID**：#{任务ID}
**创建时间**：YYYY-MM-DD HH:mm
**最后修改**：YYYY-MM-DD HH:mm

---

## 结构化教学活动需求
[项目经理写入，9 维需求]

## 教学活动设计
[教研专家产出，6 维度 + 环节设计]

## 剧本节目单
### 基础信息
- **剧本标题**：[格式：[主标题]：[知识点名称]]
- **剧本梗概**：[...]
- **艺术风格**：[英文提示词，从 skills/艺术风格 提取，不写风格名称]
- **界面风格**：[从 skills/界面风格 选择]
- **世界观 IP**：[从 skills/世界观 IP 选择]

### 道具列表
[表格格式]

### 角色列表
[表格格式，含参考图列]

### 场景列表
[表格格式，含参考图列]

### 全局变量列表
[表格格式]

### 封面
- **封面图 URL**：[...]
- **封面背景图 URL**：[...]
- **封面标题图 URL**：[...]

### 全局故事板参考图
- **故事板 URL**：[...]

### 剧本节点列表
#### S00.1 | 节点标题 | 场景名称 | 约 X 分钟
- **方案 ID**：[方案 ID（方案名称）]
- **节点描述**：[按玩家体验流程自然叙述]
- **进入时触发**：[无触发 / 数值变更：... / 获得道具：... / 学伴反馈：...]
- **分支跳转**：[标准中文条件] → [目标节点 ID]

[更多节点...]

## 颗粒脚本
- **生成时间**：YYYY-MM-DD
- **节点总数**：X
- **播放链接**：[URL]
- **编辑链接**：[URL]

---

## 生产问题与建议
[表格格式，见报告与日志文件]

报告与日志文件

# #{任务ID} {剧本标题} — 报告与日志

**项目 ID**：#{任务ID}
**创建时间**：YYYY-MM-DD HH:mm
**最后更新**：YYYY-MM-DD HH:mm

---

## 一、用户调研报告
[用户调研产出：画像 + 学习报告 + 建议]

## 二、项目经理过程性验收报告
### 2.1 环节 1：需求结构化
| 检查项 | 结果 | 说明 |
|--------|------|------|

### 2.2 环节 2：教研专家
[同上格式]

### 2.3 环节 3：游戏编剧
[同上格式]

[更多环节...]

## 三、生产问题与建议
| 序号 | 环节 | 类型 | 问题描述 | 影响范围 | 临时解决方案 | 建议改进 | 记录时间 |
|------|------|------|---------|---------|-------------|---------|---------|

## 四、生产日志
### YYYY-MM-DD HH:mm — 事件标题
- **问题/事件**：[...]
- **操作**：[...]
- **根因**：[...]

---

组件清单

Agent 角色（14 个）

编号	角色	职责	依赖 Skill
00	项目经理	主协调者、需求结构化、质量验收、流程调度	结构化需求、项目生产管理
01	教研专家	6 维度教学设计、环节详细设计	教学活动设计
02	游戏编剧	剧本节目单（节点/分支/列表）	互动游戏系统、互动游戏编剧、互动游戏方案库、世界观 IP
03	美术总监	美术资产统筹（角色/场景/道具/故事板/封面）	美术资产
04	执行编导	节点方案配置、资源生产调度	互动游戏方案库
05	脚本总装	V3 脚本组装、平台导入	script-assembly
06	资源制作	资源制作父 Agent（调度 4 个子 Agent）	资源制作管理
06a	资源制作 - 图片	AIHub 图片生产	aihub-asset-production
06b	资源制作 - 音频	TTS 音频生产	aihub-audio-production
06c	资源制作 - 视频	视频生成与合成	aihub-video-post-processing
06d	资源制作 - 互动	Web 互动页面生产	aihub-interactive-widget
07	用户调研	3 画像模拟学习、调研报告	—（基于项目文件执行）
08	协作协议	多 Agent 协作规范	—
09	团队教练	研发入口、Agent/Skill 迭代、系统审计	互动游戏颗粒生产与研发工作室、项目生产管理

业务 Skill（15 个）

Skill	用途	强制规则
项目生产管理	核心协调：文件结构规范、验收清单、流程管理	文件命名、章节结构、验收校验表
结构化需求	9 维教学活动需求解析	输出格式、必填字段、枚举值
教学活动设计	6 维度教学设计、环节设计	输出格式、知识分类框架
互动游戏系统	游戏系统规范（节点 ID、分支跳转、红线）	节点 ID 正则、方案 ID 枚举、分支格式、触发器格式
互动游戏编剧	编剧指南、节点描述规范	描述维度（检查清单，不输出标签）、叙事框架
互动游戏方案库	方案配置要求（Prompt/参数/跳转）	方案能力边界、配置字段
互动游戏资产库	游戏互动资产库管理	资产格式规范
美术资产	美术资产母页面：统一的美术生产流程、共性规范、子 Skill 索引	风格统一原则、IP 适配、Prompt 结构、@参考引用规则
↳ 角色设定参考图	角色三视图 + 动作表情参考图	生图参数、输出格式
↳ 场景参考图	场景环境概念图	生图参数、输出格式
↳ 道具参考图	道具设定图 + 细节特写	生图参数、输出格式
↳ 道具缩略图	道具图标（1:1）	生图参数、输出格式
↳ 角色立绘动画	角色立绘（9 种状态）	生图参数、9 状态列表
↳ 封面图	游戏封面（封面 + 背景 + 标题）	生图参数、输出格式
↳ 全局故事板参考图	关键镜头宫格分镜	生图参数、输出格式
资源制作管理	资源任务拆解、状态管理	任务格式、状态流转图
用户调研	3 画像模拟学习、调研报告	画像创建规则、报告格式、建议分级
aihub-asset-production	AIHub 素材生产中心（图片）	工作流参数、超时设置
世界观 IP	IP 世界观设定（如喵星人）	IP 选项枚举、转化规则
艺术风格	艺术风格提示词规范（6 种）	风格名称（无空格）、英文提示词模板
界面风格	界面风格选项	风格选项枚举
生产日志	生产问题记录与分析	问题分类、格式

---

生产流程

7 环节流水线

[1] 项目经理 — 需求结构化 + 项目初始化
  → [2] 教研专家 — 6 维度教学设计
    → [3] 游戏编剧 — 剧本节目单
      → [4] 用户调研 — 模拟学习 + 调研报告
        → [5] 美术总监 — 美术资产 + 资源任务
          → [6] 执行编导 — 方案配置 + 资源生产
            → [7] 脚本总装 — V3 脚本 + 平台导入
              → ✅ 最终交付

工作模式

模式	说明
对话模式	每个环节完成后向用户确认，用户确认后继续
托管模式	项目经理代替用户验收各环节，自动跑完全部流程

---

版本管理

版本	日期	说明
1.0.0	2026-04-23	首次发布，6 环节完整流水线
2.0.0	2026-04-23	体系重构：Agent/Skill 分工明确，文件命名统一，强制校验机制
2.1.0	2026-04-23	新增团队教练 Agent（研发入口）、README.md、用户调研 Skill、美术资产母页面、安装打包

---

安装与打包

快速安装

# 1. 解压安装包
unzip 互动游戏颗粒生产与研发工作室-v2.1.0.zip

# 2. 一键安装
cd 互动游戏颗粒生产与研发工作室-v2.1.0/
bash install.sh

# 3. 注册 Agent
easyclaw agents add project-manager --agent-dir . --workspace ~/.easyclaw/workspace --non-interactive
easyclaw agents add team-coach --agent-dir . --workspace ~/.easyclaw/workspace --non-interactive

# 4. 重启 Gateway
easyclaw gateway restart

打包发布（维护者）

打包脚本位于 skills/互动游戏颗粒生产与研发工作室/package.sh，运行后自动输出 zip 到 versions/ 目录：

cd ~/.easyclaw/workspace/skills/互动游戏颗粒生产与研发工作室/
bash package.sh
# 输出：versions/互动游戏颗粒生产与研发工作室-v{x.y.z}.zip

版本管理规范：详见同目录下的 VERSIONING.md，包含：

• 版本号规则（语义化版本）
• 打包流程
• 发布检查清单
• Agent/Skill 打包标准

系统要求

• EasyClaw ≥ 2026.3.0
• AIHub Token（~/.aihub-agent/config.json）
• BranchVideo 平台访问权限