菜单
Shows current pipeline position and routes to next action. --forensic runs 6-check integrity audit. Activates for requests involving showing current project state, routing to the next action, or a status check.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/hegemonart/get-design-done --skill gdd-progress命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Master design pipeline for Claude Code. 5-stage workflow: Brief → Explore → Plan → Design → Verify. Run 'brief' first in any new project to capture the design problem, then 'explore' to inventory the codebase and interview for context. Invoke without arguments for status and auto-routing.
Run the pipeline with optional agents skipped for speed. Skips: phase-researcher, design-assumptions-analyzer, design-integration-checker. Keeps: planner, executor, verifier, auditor. Activates for requests involving a lightweight design pass, a fast iteration, or a quick low-ceremony change.
Routes a /gdd command to fast|quick|full path + S|M|L|XL complexity_class and returns {path, complexity_class, model_tier_overrides, resolved_models, estimated_cost_usd, cache_hits}. A SKILL.md prompt the model executes to emit a routing-decision JSON from rule tables (no separate agent spawn). Optional/advisory - invoked only by the skills that opt into routing; the budget-enforcer hook tolerates its absence. Read by hooks/budget-enforcer.ts.
基于 SOC 职业分类
正在显示 SKILL.md
| name | gdd-progress |
| description | Shows current pipeline position and routes to next action. --forensic runs 6-check integrity audit. Activates for requests involving showing current project state, routing to the next action, or a status check. |
| argument-hint | [--forensic] |
| tools | Read, Bash, Grep, Glob, mcp__gdd_state__get, mcp__gdd_status, mcp__gdd_phase_current |
@reference/retrieval-contract.md
Role: Show current position in the pipeline and recommend the next action. With --forensic, run a 6-check integrity audit.
Two paths - MCP preferred when available, file-read fallback otherwise.
When the harness exposes mcp__gdd_status (Phase 27.7+, registered via npx @hegemonart/get-design-done --register-mcp):
mcp__gdd_status (no args). Returns {phase, branch, last_decisions, last_completed_plans, blocker_count} in one call.stage / task_progress for the output line, call mcp__gdd_phase_current (no args). Returns {phase, stage, task_progress, status}.This path loads the full priming context in 1–2 MCP calls (~3s, ~32k tokens - Storybloq benchmark).
When MCP tools are not available, fall back to the legacy flow:
mcp__gdd_state__get if exposed (Phase 20 STATE.md mutator MCP) → parsed state object. Otherwise, Read .design/STATE.md and parse the frontmatter + <position>, <decisions>, <plans> sections.stage, cycle, last_checkpoint, task_progress, status, decisions.length, open todos from .design/TODO.md (count unchecked - [ ] - outside the MCP catalog, so Read is still used)./gdd:brief first." and stop.This path loads the same context in 5–10 file reads (~100s, ~46.5k tokens - file-reading baseline).
━━━ Pipeline state ━━━
Stage: <stage> Cycle: <cycle or "default"> Wave: <wave>
Last checkpoint: <timestamp>
Decisions: <N> Open todos: <N>
Next: /gdd:<next-stage>
━━━━━━━━━━━━━━━━━━━━━━
Recommend next stage via the same logic as /gdd:next (route by which artifacts exist).
After the pipeline state block, if every <connections> entry from the snapshot is not_configured AND .design/config.json > connections_onboarding is absent, append once per session (transient marker .design/.connections-nudge-shown): Tip: run /gdd:connections to see what integrations can plug in (Figma, Storybook, Chromatic, etc.).
--forensic)Run these six checks and print PASS/WARN/FAIL per check:
.design/DESIGN.md against most recent file under src/ via ls -lt. WARN if DESIGN.md is older by >7 days.stage from the mcp__gdd_state__get snapshot vs artifacts present. e.g. stage=plan requires DESIGN-CONTEXT.md. FAIL if expected artifact missing.wc -c .design/DESIGN.md .design/DESIGN-CONTEXT.md; tokens ≈ bytes/4. WARN if combined >50000 tokens..design/DESIGN-DEBT.md; any item whose line predates HEAD by >14 days (check git blame or file mtime fallback) → WARN.cycle from the snapshot is set but .design/CYCLES.md has no matching heading → FAIL.<connections> field in the snapshot. WARN on mismatch.Also scan .design/SEEDS.md (if present) for seeds whose trigger keywords match the snapshot or CYCLES.md content; list them as "Seed ready to germinate: ".
Print:
━━━ Forensic audit ━━━
[PASS] Stale artifacts
[WARN] Token drift — 53,400 tokens combined
[PASS] Missing transitions
[PASS] Aged DESIGN-DEBT
[PASS] Cycle alignment
[WARN] Connection status — figma now unavailable
Seeds ready: 0
━━━━━━━━━━━━━━━━━━━━━━
After the pipeline state (and forensic audit if run), surface a one-line composition-graph hint from scripts/lib/manifest/skills.json. Count skill records declaring composes_with or next_skills, then probe for structural problems (cycles in the directed graph, or edges pointing at a skill name that has no record). Print one line:
Composition graph: <edges> edges, <skills-with-edges> skills wired | cycles: <n> | dangling: <n>Run scripts/validate-composition-graph.cjs for the authoritative cycle and dangling-edge counts when that validator is present; until then report 0 and note the graph is not yet wired. This is a readiness hint, not a gate.
When .design/context-graph.json exists, surface one line for the typed DesignContext graph using the coverage helper in scripts/lib/design-context-query.cjs (node scripts/lib/design-context-query.cjs coverage), then point at the Atomic-Design map: DesignContext graph: <pct>% node-type coverage | map: .design/INTEGRATION-MAP.md. Skip this line entirely when the graph is absent (a pre-Phase-52 project); offer /gdd:migrate-context as the next step instead. Readiness hint, not a gate.
After printing the pipeline state, emit the plugin-update banner if one is present. This file is written by hooks/update-check.sh subject to the state-machine guard (mid-pipeline stages suppress it) and per-version dismissal.
[ -f .design/update-available.md ] && cat .design/update-available.md
No-op when: no new release exists, state-machine guard is active (stage in plan|design|verify), or the latest tag has been dismissed via /gdd:check-update --dismiss.
mcp__gdd_state__get is permitted.