Phaser 4 全局工作流控制
本 Skill 是 Phaser 项目的唯一状态、风险门、任务范围和证据控制面。普通任务直接依据当前用户指令,领域 Skill 可在 Work Item 范围内迭代,完成后回到本控制面;非 Phaser 操作不进入本流程。普通任务不要求独立 taskAuthorization、授权记录或 F0 授权有效门;无副作用本地 A4 可按任务执行,带副作用的 A4-A6 操作仍保留逐对象批准。
最短主闭环
所有显示层统一按子任务规则独立分工,未就绪先登记 deferred_layers,不自动抢占宿主主线;宿主满足自身前置继续,显示层可按依赖并行准备。常驻层仍保留主图归属;待办未关闭阻断最终 V4 联合验收,子任务登记不代表通过其实现前置。
用户日常按 simplified-workflow.md 的六阶段视图理解进度:需求与范围 → 全局基线 → 基础工程 → 逐场景生产 → 全局集成验证 → 发布。单场景视觉任务在逐场景生产内显示为:场景定义 → 拆解确认 → 资源与组合验收 → 正式实现与运行验收。
- 读取当前 Work Item,记录用户原文、目标、范围、基线和验收边界;任务内修改时同步更新计划。
- 按当前阶段读取必要 reference,运行
run或check;缺少事实时先通过代码、配置、现有工件及已授权的验证查明。只有剩余问题涉及无法合理推断的实质用户取舍,才提出精确问题;可独立推进的工作继续执行。 - A3 实施前冻结实施包;实施单元、执行状态、视觉证据和文件所有权必须可复核,任务内路径、方案或资源清单变化可更新该包。
- 实施后记录候选变更审计,先推荐测试等级、理由、覆盖和命令,再自动执行定向验证并提交当前候选证据。
- 失败只按证据选择
repair、revalidate或必要的return;不得自动回滚共享工作区、扩大范围或重复已确认事实。 - 阶段任务满足验收条件后,由执行代理按下述“阶段收尾与 Git 提交”自动提交本次任务改动,再交接下一阶段。
阶段收尾与 Git 提交
- 每个阶段任务完成并通过适用验证后,执行代理自动在当前分支创建本地 Git 提交,无需再次询问;不自动创建分支、worktree 或推送远端。
run、check和状态迁移命令本身不执行 Git 提交。 - 任务开始时记录已有工作区和暂存区改动;收尾时核对实际 diff 与任务文件所有权,只暂存、提交本次任务涉及的新增、修改和删除。禁止无差别
git add .或git add -A;同一文件混有他人改动时按块隔离,无法可靠分离则保留现场并报告阻塞,不夹带已有暂存内容。 - 提交前自动检查本次产生的未跟踪文件和现有忽略规则,按需新增或更新项目
.gitignore,以最小范围忽略依赖目录、缓存、临时文件、本地日志、可再生成构建产物和本地秘密配置;将本次.gitignore修改一并纳入提交。不得忽略源码、必要资源、锁文件、交付物或验收所需证据,也不得用宽泛规则掩盖未完成工作。 .gitignore不会取消已跟踪文件的跟踪;仅对确认属于本次任务且不应入库的产物移出索引并保留本地文件,不批量清理其他历史文件,不强制添加被忽略的秘密配置。- 提交前检查选定差异与暂存内容,使用简洁中文提交说明;提交后核对提交包含的文件和剩余工作区状态,报告提交哈希、验证结果及未提交项。没有本次可提交差异时跳过空提交。验证失败、提交失败或文件归属不明时报告原因,不宣称收尾完成,不跳过 Git 钩子或自动回滚。
渐进式读取
- 只做路由或状态查询:读取本文件与
references/control-model.md的相关段落。 - 需要状态迁移或门判断:再读取
references/state-gates.md。 - 需要工件字段:按命令读取对应
references/*.schema.json,不要预加载全部 Schema。 - 需要视觉任务:读取
references/visual-stage.schema.json及对应领域合同;效果图、生成式位图、全局基线和高保真前置只在适用时读取。 - 需要 A3 委派、执行或证据:读取对应的
implementation-package、delegation、execution-state、evidenceSchema。
不可绕过约束
INTAKE → BASELINE → PROPOSAL → REVIEW → IMPLEMENTING → VALIDATING → PASSED是普通前向路径;run连续推进已满足条件的安全控制面状态,进入实施或遇到缺证据、用户决定时停止,永不自动选择RETURN。- 上述停止仅指控制命令返回。执行代理应接续完成已授权的实施、补证、修复和适用验证,再调用控制面推进;仅在缺少必要用户决定、明确批准或存在无法自行消除的外部阻塞时暂停对应工作,无依赖工作继续。
- A0-A3 直接依据当前用户任务;无外部副作用的本地 A4 集成也可按任务执行。任务内可调整方案、路径、资源清单和验证范围,并同步更新计划后继续。涉及外部写入、付费、真机、破坏性或外部删除、发布的 A4-A6 操作必须创建精确 pending,并逐对象获得显式批准。控制面不执行这些动作。
- V0→V1→V2→V3→V4 的视觉硬门、全局基线人工选择、场景 V2 拆解图确认和高保真前置均 fail closed;手写状态、根摘要或用户文字不能代替带路径与 SHA 的证据。
AUTO仅表示不存在额外产品取舍,不替代全局选图、V2 拆解、独立布局或 Spine 批次人工确认。每个门只请求其尚缺的确认;覆盖事实与绑定身份未变时复用已有有效证据,不重复询问。- 本地化翻译纳入实施与审查约束:各语言文案必须在语义准确、玩家可理解的前提下尽量精简;能用一个单词表达时不要使用两个单词,不能用冗长说明替代清晰短词。
check只读;run只读校验、推导路线并可连续写入已满足条件的安全状态步骤,不运行业务代码、测试、服务、发布或外部动作。- 只有上游事实、基线、关键候选身份、审批对象、Implementation Package 或证据身份真实变化,才使受影响旧证据失效;任务内普通路径、方案和资源清单调整只更新计划并重验受影响部分。禁止覆盖他人修改。
宽松执行原则
- 普通任务不建立独立授权凭据。用户当前指令同时提供 A0-A3 的执行依据;Work Item 只记录目标、范围、计划和结果,作为协作上下文与追踪信息。
- 缺少非关键元数据时先提醒并自动补齐;只有无法确认身份、所有权、关键产物、安全边界或用户实质取舍时才阻断。普通问题默认原地
repair,候选未变时只revalidate。 - 视觉默认检查可用性和合理关系,允许位置、尺寸、边距和换行存在小幅偏差;像素级容差、全视口/全状态矩阵仅在用户明确要求或项目合同明确指定时启用。越界、裁切、关键遮挡、不可读和交互失效仍必须修复。
- 测试按改动风险推荐 T0-T3,展示理由、覆盖和拟执行命令后自动执行适用等级;不等待人工选择,也不自动发起真机验收。
代理入口
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 顶层协议,并在 metadata.workflowView 提供展示映射、metadata.planFingerprint 提供绑定基线、授权、状态、实施包和关键输入文件哈希的确定性计划指纹。重复 check 必须只读且结果一致。
高级诊断
route 推导路线,preflight 校验动作,advance 迁移一个已满足门的状态,transition 执行显式状态迁移,diff-audit 记录候选 diff,evidence-check 校验证据,delegate-check/parallel-check/unit-check 管理 A3 执行单元,prepare-approval/handoff/approve 只服务带副作用的 A4-A6 精确操作,lint 做仓库级静态检查。高级命令不改变上述范围和硬门语义。
领域协作
$phaser4-game-orchestrator 负责领域编排;制作、架构、玩法、视觉、资源、音频、数值、QA、性能和发布 Skill 只能提交提议、审查结论、实施包或证据,并回到本控制面完成状态迁移。
详细状态、门、Schema、视觉合同和返工规则分别见 control-model.md、state-gates.md、schemas.md、visual-stage.schema.json 和 return-disposition.mjs。