akuko — 从故事到电影，一个阶段一个审核

此文件是一个路由器。 每个操作都位于其自身的 actions/ 目录文件中；按需加载并遵循。请不要在此处内联操作行为。共享规则位于 lib/ 中：

lib/state.md — 项目文件、阶段、状态转换、决策折叠。在写入任何内容之前请先阅读此文件。
lib/hosts.md — 主机检测、每个主机的能力、主机适配器。
lib/spend.md — 花费门控和成本分类账（WP-03）。lib/providers.md — 提供商（WP-03）。

项目格式为 schema/akuko-project.ts（akuko.json，JSON Schema 位于 schema/akuko-project.schema.json）。

每个操作以相同方式开始

检测主机（lib/hosts.md §检测）：A claude-artifact · B 本地 · C ikenga。运行 node --experimental-strip-types hosts/detect.ts --tools <你完整的工具列表——每个已加载和延迟加载的工具名称>。如果输出包含 warning，或者你心存疑虑，则将主机视为 A（artifact 数据库），并且永远不要创建项目文件夹。将结果记录在 akuko.json.host 中。
通过主机适配器 读取项目（readState()）；如果没有项目，则路由到 intake（或者如果用户想先配置，则路由到 setup）。
在 执行任何其他操作之前，先折叠自上次运行以来用户所做的决策（readDecisions() → lib/state.md §决策折叠）。
加载操作文件并遵循它。只能通过 writeState() 写入项目；只能通过 storeAsset() 存储文件。

路由

如果用户说…	加载此文件	所有者
"设置 akuko"、"配置"、"设置预算"、"添加我的密钥"	`actions/setup.md`	WP-08
"检查我的设置"、"缺少什么"、"诊断"	`actions/doctor.md`	WP-08
"从这个故事/剧本制作电影"、"开始一个项目"、"接收"	`actions/intake.md`	WP-04
"分解它"、"镜头列表"、"分解"、"导入镜头列表"	`actions/breakdown.md`	WP-04
"角色"、"地点"、"外观/风格"、"参考手册"	`actions/bible.md`	WP-05
"故事板"、"草图板"、"节拍板"、"板子"	`actions/board.md`	WP-21
"关键帧"、"最终画面"、"关键帧"、"连续性检查"	`actions/keyframes.md`	WP-22
"动画化"、"制作片段"、"动态"、"处理"、"摄像机运动"	`actions/motion.md`	WP-10 · WP-11 · WP-27
"口型同步"、"让他们说出台词"、"lipsync"	`actions/lipsync.md`	WP-28b
"画外音"、"音乐"、"音效"、"声音"	`actions/sound.md`	WP-12
"动画样片"、"预览电影"、"让我看看"、"粗剪"、"组装"	`actions/assemble.md`	B-11（b`preview` 已构建）· WP-13（粗剪，画面锁定：暂存）
"导出"、"发送到 Resolve"、"给我时间线"	`actions/export.md`	WP-23（Resolve 交接）
"我已审阅"、"应用我的注释"、"审阅"	`actions/review.md`	WP-07a
"给我看…"、"打开板子"、"查看"	`actions/view.md`	WP-07c
"我们进展如何"、"下一步是什么"、"状态"、"需要多少费用"、"估算"	`actions/status.md`	WP-30（整部电影估算）

导出功能将已批准的影片作为时间线及其媒体交给 DaVinci Resolve。MP4 母版、精简版和 Canva 幻灯片已搁置（计划第 7 轮）：如果请求 MP4，请告知并提供交接。

如果没有匹配项，则运行 status 并提供它建议的下一个操作。如果某个操作文件（或所请求的路由）仍显示为 暂存（WP-02），请告知用户它尚未构建并停止——不要即兴实现。动画样片也不可即兴实现：assemble preview 是已构建的免费路径，用于生成一个动画样片（将已批准的关键帧与镜头计时，绝不是审阅单元，也绝不保存到项目中）。

阶段

intake → breakdown → sketch → bible → keyframes → motion → sound → assemble → export（0-8，schema/akuko-project.ts#STAGES；电影配置文件为 profiles/film/profile.json）。仅当前面的阶段获得批准后，一个阶段才会开放（lib/state.md §阶段）。

审阅规则

以下规则在所有主机以及每个操作和视图中均适用：

只有人才能批准。 操作将单元移动到 pending-review；只有人的决策才能将单元移动到 approved。任何操作或视图均不得自动批准、预勾选或批量批准。
永远不要在未经审阅的情况下自动推进。 每个阶段以审阅门控结束（Atelier ux_mode: approve）：运行，然后暂停在生成的内容上。
阶段内一次一个单元：生成、展示、等待——不要因为一个镜头被退回而重新生成整个阶段。
决策通过决策格式（Schema 中的 Decision）进行，由审阅界面写入主机的存储。视图不得编辑 akuko.json，也不得调用 writeState()。
请求的更改需得到执行，然后标记：修改单元，添加“已修订：…”注释，将其返回到 pending-review。

花费规则

未经确认，不得进行付费调用。 每个付费任务（图像、视频、TTS）都需经过花费门控（lib/spend.md）：显示估算值、上限、已花费金额以及 如果批准后剩余金额，然后等待对该任务进行明确的批准。
无上限，不花费。 如果 akuko.json.budget 为 null，则拒绝付费任务并指向 setup。
切勿超过上限 或任务的 approved_max；相反，应停止并询问。
绝不隐藏或四舍五入费用。 每个付费调用都会记录在 ledger[] 中，无论成功或失败。
密钥保留在环境（或主机的密钥存储）中——绝不在 akuko.json、视图、artifact 数据库、分类账或板子可读取的文件中，并且绝不重复回显。在 claude.ai（主机 A）上，密钥是 每聊天粘贴一次，并且仅在即将运行付费直接调用时：首先探测网络（scripts/probe.ts），告知用户密钥将在此聊天的历史记录中可见，仅用于此聊天且绝不写入任何地方，获取“使用我的密钥用于此聊天”，然后仅在该命令的环境中设置它、保留、保存到板子、发送（lib/spend.md §主机 A, R-11）。
内部规则优先于费用。 当项目设置了 rules 时，每个任务在通过花费门控之前都要根据它们进行检查，违反规则将被拒绝（rules-breach），需注明违规的规则以及违规的文本或文件。报告并停止；切勿改写、删除引用或编辑规则以绕过它。运行 rules/cli.ts check 进行免费预检（lib/spend.md §“规则守卫（WP-26）”）。
计划配额也算作花费。 一个使用用户自己计划配额而非金钱的已连接工具（claude.ai 上 Canva 的月度 AI 限制）需要为每波动操作获得确认：数量、服务、akuko 无法看到剩余额度，以及确切的回复 approve <n> <service> generations。每次生成都记录在分类账中，金额为零并带有单位计数（lib/spend.md §配额）。

主机（一行概括）

A — claude-artifact（claude.ai）： Node 和文件仅存在于仅持续一次聊天的远程工作空间中，因此没有持久的项目文件夹。项目存在于板子 artifact 的数据库中；代理使用工具调用读取和写入它，并在工作副本上运行阶段命令。生成通过连接的 MCP（例如 Canva）、手动提示包以及粘贴了密钥的付费直接 API 进行（R-11，在网络探测之后）；MP4 在本地渲染。
B — 本地（Claude Code）： akuko.json 在磁盘上，文件在项目文件夹中，所有提供商通过环境密钥，HyperFrames + FFmpeg。
C — ikenga： B 加上 Ikenga 桥接（以及当 Studio 的 MCP 连接时的 Studio）；Studio 拥有渲染状态。

详细信息和能力证明：lib/hosts.md。

文件

SKILL.md              此路由器
actions/*.md          每个操作一个文件（Atelier frontmatter）
lib/state.md          项目文件规则、阶段、转换、决策折叠
lib/hosts.md          主机检测、能力、手动主机检查
hosts/types.ts        HostAdapter 契约（G-HOST）
hosts/{claude-artifact,local,ikenga}.ts   每个主机一个适配器
profiles/film/        电影配置文件
schema/               akuko.json 格式（G-SCHEMA）

Akuko 故事成片