基于 CNB 平台的 Twine 互动叙事游戏 NPC 协作工作流仓库。
本仓库由 7 个 NPC Agent 协作产出 Twine(Harlowe 3)互动叙事游戏:
| NPC | 角色 | 核心职责 |
|---|---|---|
| 项目经理 | PM | 拆解父 Issue 为"章节 + 工种"Issue 树 |
| 剧本写作师 | Dev | 写 .twee 剧本 passages + 资产清单 |
| 美术设计师 | Artist | AI 生图 → 双轨落盘(commit + 评论附件) |
| 配乐编导师 | BGM | 配乐编导(bgm.md):发单/下载/验收/PR;生曲由平台 @npc/bgm(节奏编织者) 执行 → 双轨落盘 |
| 资产整合师 | Integrator | 一致性校验 + 在 passage 插入 <img>/<audio> 引用 |
| 代码评审师 | Reviewer | PR 评审 + 合并 |
| 游戏测试师 | Game-Tester | L1 构建 / L2 lint / L3 资产可达 / L4 Playwright 通关 |
完整设计见 docs/superpowers/specs/2026-04-20-twine-npc-workflow-design.md。
bash start.sh
会自动:
~/.cache/twine-deps/,多次跑幂等)src/passages/*.twee 全章节 → dist/index.html跑完用浏览器打开 dist/index.html 即可试玩。
bash start.sh --chapter ch01 # 只编译某一章 → dist/ch01.html
bash start.sh --with-test # 额外装 playwright + chromium,供游戏测试师 L4 测试用
游戏测试师 L4 通关测试默认不依赖本地装 playwright;只有要本机跑
scripts/twine-smoke.sh时才需--with-test。CI(CNB game-tester-call)由流水线侧自己装。
.cnb.yml # CNB cron 任务与 NPC 注册
scripts/ # 公共脚本(评论唤醒等)
spec/
shared/ # 跨角色共享规范(标签规则等)
agent/ # 7 角色各自的执行规范(M1 填充)
ci/ # 7 角色的 CI cron 唤醒规范(M1 填充)
src/passages/ # Twine 剧本源码(一章一个 .twee 文件)
assets/ # 游戏资产(图片 / 音频;按章节分目录)
docs/ # 设计稿