SuperAPI AI 工具集

unity-game-workflow-control

智能体与模型

查看项目

更新于 10-16 09:56

技能介绍

本 Skill 是 Unity 项目的唯一流程状态、风险门、范围与证据控制面,只读取和校验 Work Item、Implementation Package、Evidence Manifest,并在门禁满足时推进控制状态;它不启动 Unity Editor、服务、设备或发布流程。

用途:冻结用户目标、范围、基线、阶段、workItemType、允许路径与验收边界,按 requirements-scope、global-baseline、foundation-engineering、scene-production、global-integration-validation、release 六个用户阶段推进。SCENE 与 DISPLAY_LAYER 须在 scene-production 独立闭环,不得混包。

主要能力:实施前冻结实施包,每个单元需有类型、所有者、路径、顺序及 Unity 序列化资源所有权;可见 SCENE/DISPLAY_LAYER 须冻结 Unity 原生 responsiveContract,实施包绑定合同文件的 path/version/sha256。实施后记录候选变更与 Evidence Manifest,证据须绑定同一 Work Item、基线和实施包。V4 PASS 要求真实 Game View/Screen/backbuffer、CanvasScaler 或 PanelSettings、Camera、Screen.safeArea、InputSystem/EventSystem 命中、同进程连续 resize、截图与候选 SHA;仅验证已批准方向,双方向或自动方向合同另需 orientation 切换轨迹。失败只能选择 repair、revalidate 或显式 RETURN,不自动回退或扩大范围。

使用方式(稳定 CLI,node 命令保持原样): node <skill-dir>/scripts/workflow-control.mjs status --repo <repo> --work-item <file> node <skill-dir>/scripts/workflow-control.mjs check --repo <repo> --work-item <file> [--implementation-package <file>] [--evidence <file>] node <skill-dir>/scripts/workflow-control.mjs run --repo <repo> --work-item <file> [--implementation-package <file>] [--evidence <file>] node <skill-dir>/scripts/workflow-control.mjs transition --repo <repo> --work-item <file> --to <state> node <skill-dir>/scripts/workflow-control.mjs lint

status 与 check 绝不写文件;run 只沿合法安全前向状态迁移,并在 IMPLEMENTING、RETURN、阶段人工确认、用户决定、缺少证据、实施包未完成或带副作用的 A4-A6 精确审批处停止;transition 是唯一显式全局状态迁移入口。SCENE 与 DISPLAY_LAYER 每个 V0–V4 阶段结束需人工确认,未确认不推进下一阶段、V4 未确认不完成工作项。稳定输出含 status、stage、changed、blocking、next、metadata 六字段,结果为诊断记录,不代表 Editor、真机或发布系统已运行。

限制:不解析旧版状态、旧版审查漏斗或非 Unity 游戏流程;所有实体字段以本 Skill schema 与 scripts 为准,仅支持 schemaVersion "1.0"。