Animade 项目工作流
这是 Animade 工作的项目入口。请将 animade-cli 作为唯一的集成面；MCP 是可选的，正常 CLI 工作流并不需要它。
在项目中的首次使用
在项目中首次收到 Animade 请求时，应在要求用户运行任何 Animade 命令之前自动准备环境。如果 animade-cli --json version 不可用，或项目没有 .animade/setup.json，请在用户项目中运行本 Skill 的 bootstrap：
node <animade-skill-directory>/scripts/bootstrap.mjs "$PWD"
不要要求用户单独安装 CLI 或 Runtime。bootstrap 会全局安装 Cloud 选定的 animade-cli npm 包、安装匹配的本地 Runtime、在 CLI 没有有效会话时打开 Animade Cloud 进行浏览器授权，并在 .animade/ 下写入项目配置。它返回已安装 CLI 的绝对可执行路径；如果用户 shell 尚未刷新全局 npm PATH，请在当前运行中使用该路径。
Runtime 安装器与 bundle 经过 SHA-256 校验。浏览器登录使用带 PKCE 的 OAuth 2.0 授权码流程；回调仅绑定回环地址，CLI 将其访问与刷新凭据存储在其私有用户配置中。切勿将这些凭据打印或复制到提示词中。仅在开发或单独部署的 Animade Cloud 场景下设置 ANIMADE_CLOUD_ORIGIN。
选择不使用本 Skill 而直接使用 CLI 的用户，可以像其他 npm 命令行工具一样持久安装：
npm install --global animade-cli animade-cli onboard --project-root "$PWD"
如需一次性 CLI 调用而不做持久安装，请使用：
npx --yes animade-cli@latest onboard --project-root "$PWD"
完成 onboarding 后，在创建或更改媒体之前运行以下检查：
animade-cli --json doctor --project-root "$PWD" animade-cli --json auth status
使用 animade-cli --json runtime start 启动或复用已安装的 Runtime。
如果状态为未认证，请在受保护操作前停止，并使用：
animade-cli login
如果 CLI 无法启动浏览器，请保持 CLI 进程运行并使用 animade-cli login --no-open。将打印出的授权 URL 交给用户在本地打开；回环回调会完成同样的 PKCE 流程。切勿要求用户将回调 URL 或令牌粘贴到对话中。
CLI 将凭据存储在其用户私有配置目录中。切勿将令牌复制到提示词、文档、Recipe、提交或媒体 URL 中。
分阶段创建
获取当前指令，而不是将其复制到本 Skill 中：
animade-cli --json recipes list animade-cli --json recipes get <recipe-id> animade-cli --json knowledge get <module-id> animade-cli --json preflight --region global
使用返回的 Recipe 哈希创建 Workflow，并保持默认的人工把关模式，除非用户通过批准说明明确授权全自动化。按以下顺序工作：
Director：明确意图、受众、约束以及最小可用的场景计划。
Visual：在扩展之前制作并检查一个有代表性的视觉样本。
Motion：基于已批准的样本确定时间与转场。
Audio：创建或导入旁白，然后在确定场景时长之前校准 VoiceTiming。
Composition：组装本地项目、字幕与导出；在报告完成之前使用 Runtime 检查生成的 MP4。
记录各阶段产物与评审及其 SHA-256 哈希和当前修订版本。遇到修订冲突时，重新加载并协调；切勿盲目覆盖。为生成 Job 使用稳定的幂等键。未知的 Job 提交结果并不等于允许使用新键重试。
简报、阶段笔记与评审证据优先使用本地项目文档：
animade-cli --json document write --project-id <project-id> --name brief.md --content-file brief.md animade-cli --json project update <project-id> --revision <revision> --changes '{"scenes":[]}' animade-cli --json export start --project-id <project-id> --revision <revision>
将提供商凭据与私有源媒体保留在它们现有的私有存储中。不要仅为测试集成而生成提供商媒体；除非用户另行授权生成，否则请使用 doctor、catalog、API 与本地 Runtime 夹具。