logo
0
0
WeChat Login

twine-workspace

基于 CNB 平台的 Twine 互动叙事游戏 NPC 协作工作流仓库。

简介

本仓库由 7 个 NPC Agent 协作产出 Twine(Harlowe 3)互动叙事游戏:

NPC角色核心职责
项目经理PM拆解父 Issue 为"章节 + 工种"Issue 树
剧本写作师Dev.twee 剧本 passages + 资产清单
美术设计师ArtistAI 生图 → 双轨落盘(commit + 评论附件)
配乐编导师BGM配乐编导(bgm.md):发单/下载/验收/PR;生曲由平台 @npc/bgm(节奏编织者) 执行 → 双轨落盘
资产整合师Integrator一致性校验 + 在 passage 插入 <img>/<audio> 引用
代码评审师ReviewerPR 评审 + 合并
游戏测试师Game-TesterL1 构建 / L2 lint / L3 资产可达 / L4 Playwright 通关

完整设计见 docs/superpowers/specs/2026-04-20-twine-npc-workflow-design.md

试玩(一键就绪)

bash start.sh

会自动:

  1. tweego v2.1.1(缓存到 ~/.cache/twine-deps/,多次跑幂等)
  2. 编译 src/passages/*.twee 全章节 → dist/index.html
  3. 给出可直接打开的本地路径

跑完用浏览器打开 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/                   # 设计稿

About

全自动化跑通生成 一个 Twine 游戏。包括文字,网页,音频,tss.

Language
Shell92.7%
JavaScript6.1%
CSS1%
Python0.2%