SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场threejs-game-workflow-control

threejs-game-workflow-control

编程与开发

查看项目

更新于 10-16 09:19

技能介绍

用途

threejs-game-workflow-control 是 ThreeJS 游戏仓库的唯一全局工作流控制面。它按当前任务范围和确定性风险分类处理本地工作，并仅对带副作用的 A4-A6 操作及影响保留精确显式批准。本 Skill 是该项目的唯一状态、风险门、任务范围和证据控制面；普通任务直接依据当前用户指令，领域 Skill 可在 Work Item 范围内迭代，完成后回到本控制面；非 ThreeJS 操作不进入本流程。

主要能力

  • 状态与门控制：维护 INTAKE → BASELINE → PROPOSAL → REVIEW → IMPLEMENTING → VALIDATING → PASSED 的普通前向路径。run 连续推进已满足条件的安全控制面状态，进入实施或遇到缺证据、用户决定时停止，永不自动选择 RETURN。
  • 风险批准分级：A0-A3 直接依据当前用户任务；无外部副作用的本地 A4 集成也可按任务执行。涉及外部写入、付费、真机、破坏性或外部删除、发布的 A4-A6 操作必须创建精确 pending，并逐对象获得显式批准。
  • 六阶段项目视图：用户日常按需求与范围 → 全局基线 → 基础工程 → 逐场景生产 → 全局集成验证 → 发布理解进度。单场景视觉任务按场景定义 → 拆解与布局确认 → 正式资源验收 → 正式还原与运行验收推进。
  • 实施包与审计：A3 实施前冻结实施包，实施单元、执行状态、视觉证据和文件所有权必须可复核；实施后记录候选变更审计，先推荐测试等级、理由、覆盖和命令，再自动执行定向验证并提交当前候选证据。
  • 阶段收尾与 Git 提交：阶段任务满足验收条件后，由执行代理自动在当前分支创建本地 Git 提交，不自动创建分支、worktree 或推送远端。禁止无差别 git add . 或 git add -A。
  • 渐进式读取：只做路由或状态查询时读取本文件与 control-model.md 相关段落；需要状态迁移或门判断时再读取 state-gates.md；需要工件字段时按命令读取对应 schema，不预加载全部 Schema。
  • 视觉任务处理：遵循图片优先的确认方式，代理内部维护分析、技术记录与提示词，直接交付真实图片或预览供人工确认。三维世界使用独立嵌套 responsiveContract.renderSpace=world-3d，二维固定设计合同仅用于 HUD。
  • 程序化文本硬约束：必须同时实现英语 en、简体中文 zh-CN、日语 ja、俄语 ru、西班牙语 es，并以各语言真实字形宽度、基线、字体回退和容器适配完成显示验证，禁止截断。

使用方式

代理入口命令：

node <skill-dir>\scripts\workflow-control.mjs run --repo . --work-item <work-item> [--input <file> ...]
node <skill-dir>\scripts\workflow-control.mjs check --repo . --work-item <work-item> [--implementation-package <package>] [--evidence <manifest>] [--input <file> ...]
node <skill-dir>\scripts\workflow-control.mjs status --repo . --work-item <work-item> [--input <file> ...]

三个入口可重复传入 --input <file> 绑定显式关键输入；默认文本优先显示六阶段/四步场景视图，--json 仍输出稳定的 status/stage/changed/blocking/next/metadata 顶层协议。check 只读；run 只读校验、推导路线并可连续写入已满足条件的安全状态步骤，不运行业务代码、测试、服务、发布或外部动作。

高级诊断命令包括 route（推导路线）、preflight（校验动作）、advance（迁移一个已满足门的状态）、transition（执行显式状态迁移）、diff-audit（记录候选 diff）、evidence-check（校验证据）、delegate-check/parallel-check/unit-check（管理 A3 执行单元）、prepare-approval/handoff/approve（只服务带副作用的 A4-A6 精确操作）、lint（仓库级静态检查）。

适用场景

  • ThreeJS 游戏项目的全局工作流状态与风险管理。
  • 单场景视觉任务的规划、实现与验收。
  • 弹窗类瞬态显示层按独立工作项规则处理。
  • 涉及多语言程序化文本（en、zh-CN、ja、ru、es）的界面实现。
  • 需要 Git 提交收尾与 .gitignore 管理的阶段任务。

领域协作与限制

$threejs-game-orchestrator 负责领域编排；制作、架构、玩法、视觉、资源、音频、数值、QA、性能和发布 Skill 只能提交提议、审查结论、实施包或证据，并回到本控制面完成状态迁移。

限制与注意事项：机器合同不能替代人工视觉或实际设备验收，摘要不参与验收。工作流所有任务与阶段取消 SHA-1、SHA-256、文件哈希和候选摘要的验收校验。测试按改动风险推荐 T0-T3，但不自动发起真机验收。视觉默认检查可用性和合理关系，像素级容差、全视口/全状态矩阵仅在用户明确要求或项目合同明确指定时启用。详细状态、门、Schema、视觉合同和返工规则分别见 control-model.md、state-gates.md、schemas.md、visual-stage.schema.json 和 return-disposition.mjs。