Mangou
Mangou 用 YAML 管理资产和分镜,用 CLI 执行生成与回填,适合把 AI 漫剧流程收敛成可审计、可批量执行的项目目录。
Use this skill when
- 用户要初始化 Mangou 项目或整理项目目录
- 用户要编写或修正
asset_defs/*.yaml、storyboards/*.yaml - 用户要生成分镜图片、视频,或切分 grid 母图
- 用户要拼接全片、排查
tasks.jsonl或 YAML 回填状态 - 用户要确认 Mangou skill、本地 runtime、dashboard 各自怎么安装
Quick start
按这个顺序执行:
Mangou checklist
- [ ] 确认技能已安装
- [ ] 优先通过 vercel-labs/skills 安装技能入口
- [ ] 轻量安装态不包含 Bun runtime,不要直接假设 `src/main.ts` 已存在
- [ ] 需要 CLI 时,优先运行 `node bootstrap-runtime.mjs`
- [ ] 需要本地只读页面时,再安装独立 dashboard 包
- [ ] 检索工作区记忆:开始任务前检查 `workspace/.mangou/memories/`
- [ ] 先读项目目录规范,再改 YAML
- [ ] 生成后只信任 tasks.jsonl 和 YAML latest 回填
- [ ] 失败时先读 error,再修正参数或 prompt
- [ ] 沉淀经验:任务完成后,询问用户是否总结记忆库
- 安装和 runtime 合并:见 INSTALL.md 和
node bootstrap-runtime.mjs - 项目目录和路径约束:见 knowledge/directory.md
- 资产 YAML:见 knowledge/assets.md
- 分镜 YAML:见 knowledge/storyboards.md
- 常用命令:见 COMMANDS.md
Operating rules
- 先改 YAML,再运行命令;不要跳过配置直接猜测参数。
- 轻量 skill 初始安装只有文档和
knowledge/;如果技能根目录还没有src/main.ts,先安装 runtime,再执行 Bun 命令。 - 所有资源路径都用相对项目根目录的显式路径。
- 脚本不会为任何任务自动补
provider;tasks.image.provider和tasks.video.provider都必须在 YAML 里显式写出。 - 任务状态以
tasks.jsonl为唯一真相源,YAMLlatest是投影缓存。 storyboard split只依赖meta.grid/--grid,不要靠 prompt 文本推断宫格。- 生成失败时先检查
error、latest、tasks.jsonl末尾记录,再决定是否重试。 - skill 入口、Bun runtime、dashboard 是三层产物;不要把它们当成同一个安装物。
- 记忆优先原则:所有 AIGC 相关操作必须前置检索用户工作区记忆 (
workspace/.mangou/memories/),如有冲突以时间较近的记录为准。 - 闭环总结:调优成功后必须主动引导用户将心得总结到工作区记忆库。
Reference map
- 安装与下载:INSTALL.md
- 命令与调用格式:COMMANDS.md
- 项目目录:knowledge/directory.md
- 资产定义:knowledge/assets.md
- 分镜规范:knowledge/storyboards.md
- 连续性与一致性:knowledge/consistency.md
- 导演式分镜原则:knowledge/director.md
- Prompt 策略:knowledge/prompts.md
- BLTAI 参数:knowledge/provider-bltai.md
- EvoLink 参数:knowledge/provider-evolink.md
- 任务真相源与回填:knowledge/tasks.md
- 记忆模块规范:memories/README.md
默认推荐:
- 图片生成优先推荐
bltai - 视频生成优先推荐
evolink