gat-workflow-start
GitHub作为简化项目的流程路由器,检查gat/目录状态并生成里程碑面板。根据文件存在情况推导阶段,按优先级推荐最早的可执行步骤(如头脑风暴、叙事设计或系统设计),并列出其他有效操作。
Trigger Scenarios
Install
npx skills add Yuki001/game-dev-skills --skill gat-workflow-start -g -y
SKILL.md
Frontmatter
{
"name": "gat-workflow-start",
"description": "Inspect the repo state and show a status panel across all milestones, recommending the earliest actionable next step in the workflow.",
"allowed-tools": "Read, Glob, Grep, AskUserQuestion",
"argument-hint": "[no arguments]",
"user-invocable": true
}
Workflow Start
This skill is the workflow router for the simplified project. Because milestones can be in progress at different stages at the same time, it outputs a status panel (not a single command) and recommends the earliest actionable step.
Read only gat/ paths. Do not read or consider legacy design/ or production/
paths.
Phase 1: Inspect State
Check for these files (all under gat/):
gat/overview/game.mdgat/overview/systems-index.mdgat/overview/art-direction.mdgat/narrative/*.mdgat/milestone/milestone.md- each
gat/milestone/m{N}-<name>/m{N}-brief.md - each system's docs under
gat/milestone/m{N}-<name>/<system>/
Phase 2: Derive Per-Milestone Stage
For each milestone that has an m{N}-brief.md, derive its stage from filesystem
state:
planned— brief exists, all systems Pending (no GDDs on disk)designing— at least one system designed but not alldesigned— every in-scope system's GDD (and art/data where required) is on disk
If the brief's status field disagrees with filesystem state, derive the stage from filesystem state.
Phase 3: Status Panel
Report a short factual summary:
GAT Status:
Overview:
gat/overview/game.md [present | missing]
gat/overview/systems-index.md [present | missing]
gat/overview/art-direction.md [present | missing]
Narrative:
gat/narrative/*.md [N docs | missing]
Milestones (from gat/milestone/milestone.md):
M1 <name> [planned | designing | designed] (K/N systems designed)
M2 <name> [planned | designing | designed] (K/N systems designed)
...
Phase 4: Route
Use earliest-first priority to pick the primary recommendation, and list other valid actions:
- If
gat/overview/game.md,gat/overview/systems-index.md, orgat/overview/art-direction.mdis missing: recommend/gat-brainstorm(with optional hint). This is the earliest step. - Else if the game needs narrative (per overview/user goal) and
gat/narrative/story.mddoes not exist: recommend/gat-story. - Else if
gat/milestone/milestone.mdis missing: recommend/gat-milestone. - Else if the earliest milestone with unwritten systems exists:
recommend
/gat-design <that milestone>(continue) or/gat-design <that milestone> <system>. - Else if the earliest milestone is fully
designedbut no later milestone needs design: state that the milestone is ready for engineering handoff (the user runs their downstream engineering workflow on that milestone directory; the brief includes detailed internal iterations for the downstream workflow to handle). - Otherwise: state that GAT pre-production is complete for all planned milestones and tell the user to hand milestones one at a time to their downstream engineering workflow.
Always also list other valid actions (e.g., "M1 ready for engineering; M2
designing — run /gat-design m2-<name> to continue M2").
Phase 5: Hand Off
End with one short line telling the user which command to run next (the primary recommendation), plus any alternative actions.
Version History
-
f392d12
Current 2026-07-19 18:50
新增内部迭代信息至里程碑;指出当前里程碑过大,不适合迭代开发。
- 832aed0 2026-07-05 15:18


