这是 Claude Code 游戏工作室工作流中的一个只读导航技能,运行时只报告发现,不写入任何文件。它的作用是判断项目当前的位置,并告诉用户最该做的一件事。
主要路径依次为:先制作一个游戏(/prototype),试玩后提出修改,再把它扩展为持续开发的项目。资料中列出的各阶段及其设计文档、代理、team-* 流水线与阶段关卡属于工作室模式,即 workflow 为 standard(标准)或 full(完整)时的路径。该技能是轻量检查而非完整审计;如需完整差距分析,应使用 /project-stage-detect。
运行前会解析 project.stage 与 workflow 两项配置。project.stage 是判断当前阶段的权威值,已包含 project.yaml → production/stage.txt 的回退逻辑,并保留含空格的值(如 Systems Design);workflow 决定标准与完整两条工作流的层级。若无配置块,则按 .claude/docs/config-resolution.md 中的默认值回退。
工作流程:先读取 .claude/docs/workflow-catalog.yaml 获得全部阶段、步骤顺序、必选/可选标记及完成产物;再列出 .claude/skills//SKILL.md,找出未收录在目录中的技能,作为页脚提示(最多 10 个,按阶段相关性筛选)。随后确定当前阶段:minimal 模式下跳过阶段阶梯,直接走最小路径(引擎 → 设计/game-brief.md → 故事 → /dev-story ↔ /story-done);否则将 project.stage 映射到目录阶段键,或在未设置时按产物推断(源码文件 10 个以上为 production,存在 story-.md 为 pre-production,依此类推)。接着读取 production/session-state/active.md 中 STATUS 与 CHECKPOINT 区块,了解最近工作与阻塞点。
对当前阶段各步骤,通过 artifact-check.sh 一次性检查产物,状态映射为 Complete / Incomplete / MANUAL / UNKNOWN;NO_CHECK 绝不等同于完成。production 阶段优先读取 production/sprint-status.yaml,按 in-progress、ready-for-dev、done、blocked 呈现故事状态。可重复步骤(如 System GDDs)只说明已检测到工作,可能仍在进行。
最小路径下,按 engine-setup → game-brief → create-stories → 故事 的顺序给出下一步;若存在故事,则依据 story-status.sh 输出,优先处理 IN_REVIEW、再 IN_PROGRESS、再 TODO,BLOCKED 故事永远不作为下一步。对“深化系统”的故事,若缺少 design/gdd/<system>.md,会先建议 /design-system。全部故事完成时,提示试玩、继续加功能或用 /project-settings 提高严谨度。若故事数、功能数或系统数达到 9 个或四个系统的阈值,会建议一次工作室模式迁移,但这只是建议。
标准与完整工作流下,技能会给出最后完成的必选步骤、当前阻塞项(第一个未完成的必选步骤)、可选机会(full 全部列出,standard 仅列当前阶段必需项)以及后续必选步骤。若用户传入参数(如“刚完成设计评审”),会以此推进。若有设计文档但无可玩原型,会建议先做可玩原型。
限制:只读,不写文件;不做完整审计;minimal 模式下不得将概念文档、美术圣经、系统地图、GDD、/create-epics、冲刺计划、/gate-check 等作为必需项或阻塞项展示。