菜单
Off-context Figma design-system extraction into a compact local digest (DESIGN.md + tokens.json + components.json). Pulls the file via the Figma REST API and digests it without the raw JSON ever entering the model context.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/hegemonart/get-design-done --skill gdd-figma-extract命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 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-figma-extract |
| description | Off-context Figma design-system extraction into a compact local digest (DESIGN.md + tokens.json + components.json). Pulls the file via the Figma REST API and digests it without the raw JSON ever entering the model context. |
Pull a whole Figma design system into a compact, queryable local digest - without the raw JSON ever entering Claude context. The heavy lifting runs in tested .cjs tools; the model reads only the digest outputs.
/gdd:figma-extract <file-key-or-url> # full design-system digest
/gdd:figma-extract <file-key-or-url> --component Button # ~500-token single-component slice
<file-key-or-url> is a Figma file URL (https://www.figma.com/file/<key>/… or /design/<key>/…) or a bare file key.
Preflight (D-10). Confirm FIGMA_TOKEN is set in the environment:
node -e "process.exit(process.env.FIGMA_TOKEN||process.env.FIGMA_PERSONAL_ACCESS_TOKEN?0:1)"
If unset, tell the user to export FIGMA_TOKEN=figd_… (from https://www.figma.com/developers/api#access-tokens). The token comes from the environment only - never ask the user to paste it into a file or the chat, and never echo it back.
Stage 1 - pull. Pull the file's REST endpoints into the gitignored raw cache (D-09):
node scripts/lib/figma-extract/pull.cjs "<file-key-or-url>"
This caches to .figma-extract-cache/raw/<file-key>/ and skips re-pulling when Figma's version is unchanged (D-11). Add --force to bypass the cache, --out <dir> to relocate the cache. The tool prints a JSON summary (endpoints, bytes, cached) on stdout - the raw bodies stay on disk.
Stage 2 - plugin sync (OPTIONAL, Path C). Only when the design tokens live in Figma Variables that the REST API cannot return (non-Enterprise plans → the pull summary shows variables skipped) and the user wants token coverage:
node scripts/lib/figma-extract/receiver.cjs --out .figma-extract-cache/raw/<file-key>
This binds 127.0.0.1:5179 (D-06). Tell the user to run the dev-installed "GDD Sync" plugin in Figma and click "Export to GDD" - see figma-plugin/README.md for the one-time dev-install. The receiver writes variables.json into the cache and exits on receipt or timeout. Skip this stage entirely for design systems whose tokens already come through the REST pull.
Stage 3 - digest. Transform the cache into the compact digest:
node scripts/lib/figma-extract/digest.cjs --raw .figma-extract-cache/raw/<file-key> --out .figma-extract-cache/digest
This writes DESIGN.md, tokens.json, and components.json. Add --prefer-styles to invert the token priority to styles-first (D-04). Add --component <name> (D-08) to emit a single-component slice instead of the full digest.
Read the digest. Open only .figma-extract-cache/digest/DESIGN.md (plus tokens.json / components.json when you need structured data). For a single component, pass --component <name> in Stage 3 and read the ~500-token slice instead of the full ~16K-token spec.
.figma-extract-cache/digest/DESIGN.md - the compact human/LLM-readable spec.figma-extract-cache/digest/tokens.json - resolved design tokens (when structured token data is needed).figma-extract-cache/digest/components.json - components with variants/props/defaults (when structured component data is needed)cat the raw/*.json cache (e.g. .figma-extract-cache/raw/<file-key>/file.json). It is tool-internal and often 100+ MB; loading it into context defeats the off-context guarantee (D-12). Read only the digest outputs above.FIGMA_TOKEN (D-10). It belongs in the environment only - never write it to a file, a commit, or chat output.