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 diskbuilding/built— user-set only; GAT cannot observe engineering. Read the status field fromm{N}-brief.mdif the user has advanced it pastdesigned.
If the brief's status field disagrees with filesystem state, trust the brief's
status only when it is building or built (engineering stages GAT can't
derive); otherwise derive from files.
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 | building | built] (K/N systems designed)
M2 <name> [planned | designing | designed | building | built] (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). - 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
- 832aed0 Current 2026-07-05 15:18


