screens
Use to produce the canonical screen manifest for a UI feature — every screen in every state (default / loading / empty / error / success / validation), with reuse-first component picks — written to docs/features/{slug}/screens.md between api and tasks. Draws per the design-system tool: Figma MCP into the canon file, Pencil MCP into screens.pen, or inline markdown wireframes (code mode — also the degradation when an MCP is unavailable). Triggers on "screens for {slug}", "screen states for {slug}", "draw the screens", "mockups for {slug}", "/sdd:screens {slug}", "екрани для {slug}", "стани екранів {slug}", "намалюй екрани". States derive from §5 ACs + sad.md §6 branches + contract error responses; tasks/implement/review read ONLY the manifest. Hard-refuse if sad.md is missing; skipped when target_surfaces declares no UI surface.
genkovich · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add genkovich/sdd --skill screens技能说明
name: screens model: inherit effort: high agents: [] description: > Use to produce the canonical screen manifest for a UI feature — every screen in every state (default / loading / empty / error / success / validation), with reuse-first component picks — written to docs/features/{slug}/screens.md between api and tasks. Draws per the design-system tool: Figma MCP into the canon file, Pencil MCP into screens.pen, or inline markdown wireframes (code mode — also the degradation when an MCP is unavailable). Triggers on "screens for {slug}", "screen states for {slug}", "draw the screens", "mockups for {slug}", "/sdd:screens {slug}", "екрани для {slug}", "стани екранів {slug}", "намалюй екрани". States derive from §5 ACs + sad.md §6 branches + contract error responses; tasks/implement/review read ONLY the manifest. Hard-refuse if sad.md is missing; skipped when target_surfaces declares no UI surface.
Skill: screens
Turns the approved architecture into the screen manifest — the one artifact tasks,
implement and review read for what every screen shows in every state. It runs between api
and tasks: by then the states are derivable, not invented — default plus every state the
spec §5 ACs, the sad.md §6 alt/else branches, and the contract error responses imply
(loading / empty / error / success / validation). Per state it names the components to reuse
from the docs/design-system.md inventory — a NEW: component only with a
why-no-primitive-fits justification. The visuals are drawn per the canon's tool; whatever the
tool, the manifest is the contract — downstream never reads the raw Figma/.pen file.
Optional by surface: its N/A condition (no UI surface in sad.md target_surfaces) lives in
../_shared/size-matrix.md and is evaluated by api's handoff
(carried forward when api itself is N/A). Invoked directly, it always runs.
Question phrasing → ../_shared/ask-style.md. Manifest prose follows
artifact_language — state tokens (default/loading/…), SCR ids, component names and
source-refs stay English → ../_shared/artifact-language.md.
Owner
Designer + frontend lead. The PM confirms the states match the ACs; review later checks the
built screens against this manifest.
Inputs
<slug>— feature slug.- Gate (hard-refuse if missing):
docs/features/<slug>/sad.md—target_surfaces+ the §6 branches feed the state derivation. Absent → STOP: «rundesign <slug>first». - (Expected)
docs/features/<slug>/ux-flows.md— the SCR inventory this manifest details. Absent → soft: offer/sdd:ux-flows <slug>first, or derive the inventory from spec §4 + the SAD with a noted gap in the manifest — never a silent invention. - (Expected)
docs/design-system.md— thetool+ the component inventory. Absent →codemode- recommend
/sdd:design-systemin the handoff.
- recommend
- (Read)
docs/features/<slug>/contracts/(error responses → error states),spec.md§5 (ACs → states),.size/.route(depth + handoff resolution; defaults stated loudly when missing).
Protocol
- Gate + read.
test -f docs/features/<slug>/sad.md→ missing = refuse with the pointer above. Readtarget_surfaces(no UI surface declared → say so and STOP — this stage is for UI features; the upstream handoff normally skips it). Readux-flows.md(or run the soft fallback above),docs/design-system.md(tool+ inventory),sad.md§6,contracts/, spec §5. Readinterview_depth(else medium;--depth=wins) — it governs the per-screen confirm volume. - Derive states per screen. For each
SCR-NNfrom the inventory, list the full state set:default+ every state the ACs / §6 branches / contract errors imply; a state class that genuinely doesn't apply gets one explicitN/A: <reason>row. Pick the components per state — from the design-system inventory by name; aNEW: <name>only when no existing primitive fits, with the one-line why. Confirm per screen Socratically (medium/hard: oneAskUserQuestionper screen — Accept / Fix / Save-as-OQ / Drop; easy: derive + ledger, ask only where the AC↔state mapping is genuinely ambiguous). - Draw per the canon's
tool.figma→ draw into the canon'sfigma_filevia the Figma MCP, record the node-id per state;pencil→batch_designintodocs/features/<slug>/screens.pen, record node ids;code→ inline markdown wireframes in the manifest. Degrade, don't block: the tool's MCP unavailable in this session → fall back tocodemode and name the degradation in the manifest §Source + the handoff (→../_shared/tool-adapters.md). - Write the manifest + commit. Fill
./templates/screens.md→docs/features/<slug>/screens.md(frontmattertoolcopied from the canon; §Source; one### SCR-NNsection per screen; §New components). Stampupdated_at; propose commitscreens: <slug> manifest. - Structural self-check — per
../_shared/self-check.md: re-read the manifest from disk and verify 4 items: (1) everySCR-NNfromux-flows.mdhas a section (inventory fully covered — or the noted-gap fallback is stated); (2) every screen shows ≥default+ (errororempty) — or carries the explicitN/A: <reason>row; (3) every component name exists in the design-system inventory or sits in §New components with a justification; (4) forfigma/pencil, every state row carries a source-ref (node-id) — forcode, the wireframes are present. Fix + re-check ≤2 cycles; surface anything unresolved. - Handoff. Emit the stage-handoff block per
../_shared/handoff.md— What I did (tool used or the degradation, «self-check: 4/4 pass») + Review (`