跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

ui-design

Designs the screens — the presentation half of each feature's low-level design, sibling to detailed-design. Runs in three modes: anchor (right after ux-foundations, designing 2-3 key screens to validate the design system before features build on it), per-feature (the construction loop — after detailed-design, designing that feature's SCR screens against its contracts), and re-verification (after a design.md amendment). Resolves strategy per screen: picks up screens that already exist in a connected design tool (Figma, Claude Design, Figma Make, Open Design, or any design tool), otherwise falls back per project policy to code-native specs or generation. Emits one uniform contract — docs/design-manifest.json keyed on SCR IDs — that downstream implementation reads regardless of which tool or strategy produced each screen. Trigger on "design the screens", "design anchor screens", "design this feature's UI", "ui design for", or "register the Figma designs". Screens conform to design.md or e

zeeshanhanif · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add zeeshanhanif/agentic-sdlc-kit --skill ui-design

技能说明


name: ui-design description: >- Designs the screens — the presentation half of each feature's low-level design, sibling to detailed-design. Runs in three modes: anchor (right after ux-foundations, designing 2-3 key screens to validate the design system before features build on it), per-feature (the construction loop — after detailed-design, designing that feature's SCR screens against its contracts), and re-verification (after a design.md amendment). Resolves strategy per screen: picks up screens that already exist in a connected design tool (Figma, Claude Design, Figma Make, Open Design, or any design tool), otherwise falls back per project policy to code-native specs or generation. Emits one uniform contract — docs/design-manifest.json keyed on SCR IDs — that downstream implementation reads regardless of which tool or strategy produced each screen. Trigger on "design the screens", "design anchor screens", "design this feature's UI", "ui design for", or "register the Figma designs". Screens conform to design.md or escalate — never fork it.

UI Design

The presentation half of the feature's low-level design — detailed-design's conceptual sibling, but sequential in the loop: in per-feature mode this skill consumes the feature's technical-design.md (screens bind to its contracts — a screen displays what an endpoint returns), which is why detailed-design runs first. Only anchor mode, which precedes any feature, has no such dependency. It answers, per screen: what does it look like, what does it compose from, what states does it cover, where does its design authority live. Its defining characteristic is that it's an adapter: how screens get designed varies by project (an existing design file, a generation tool, straight to code), so this skill routes across strategies while emitting one uniform output contract — the design manifest — that everything downstream reads, whatever produced each screen. All design-tool variance is absorbed here; no downstream skill ever learns what a Figma node is.

Three principles govern it:

  1. Strategy is resolved per screen, not per project. A project with a partial design file is "register" for the screens that exist and the project's fallback policy for the rest. The manifest lookup by SCR ID is always the first move.
  2. Screens conform to the design system or escalate — never fork it. docs/design.md + tokens.json are the authority. A fetched or generated screen introducing an off-system color, component, or pattern is either corrected to the system, or the system is amended through ux-foundations' amendment path (the presentation analog of detailed-design's schema escalation). Local work never silently mutates upstream authority.
  3. The manifest is the only registry. With per-screen routing, no design tool ever holds the complete picture — only docs/design-manifest.json does. This skill is its single writer.

Inputs

Defaults below; user paths win; source-gated citation throughout (SCR/FEAT/ FR/UC/NFR IDs only from documents that exist; never fabricate).

  • Design system — docs/design.md + docs/tokens.json (from ux-foundations). The authority every screen conforms to. Also read design.md's structured design_provenance block (mode and fidelity drive the anchor recommendation) and ux-foundations.md's screen inventory (SCR IDs, purposes, states) and per-surface profiles.
  • Feature context (per-feature mode) — the feature's technical-design.md (contracts the screens bind to: a screen displays what an endpoint returns) and its plan entry (SCR IDs, FR/UC trace).
  • The manifest — docs/design-manifest.json, if it exists: what's already designed, by which strategy, and the project's routing policy.
  • Connected design tools — whatever design-tool MCPs are connected. Treated capability-first (see references/design-tool-integrations.md): tools are interchangeable engines behind two capabilities — enumerate/export existing designs and generate from a system spec.

Outputs

  1. docs/design-manifest.json — the global, SCR-keyed screen registry: one entry per screen with strategy, source locator, states coverage, contract bindings, conformance result, status. Single-writer; entries appended/updated by this skill only. Schema: references/manifest-guide.md.
  2. docs/features/FEAT-NNN-<slug>/ui-design.md (per-feature mode) — the human-readable screen specs and decisions, beside technical-design.md. Anchor mode writes docs/anchor-screens.md instead (no feature folder exists yet).
  3. RTM append (docs/rtm.md, if present; silent skip otherwise): the feature's ui-design ref appended into Design ref for the FRs whose screens it designs — append-only, that column only.
  4. Escalations (when the authority rule trips): a proposed design-system amendment filed toward ux-foundations, recorded in the manifest entry — never a silent local fork.

Workflow

Phase 0 — Mode detection

Determine the mode from context and intent; confirm when ambiguous:

  • Anchor — ux-foundations just completed, no features designed, or the user asks for anchor/key screens. Purpose: validate that the design system composes before features build on it.
  • Per-feature — a feature's technical-design.md exists (or the user names a FEAT); the loop mode.
  • Re-verification — design.md was amended; re-check the manifest entries whose screens the amendment affects (changed tokens/components), update conformance results, flag screens needing rework.

Anchor recommendation gradient (state it, let the user decide — anchors are recommended, never mandatory): strongly suggested when design.md's provenance is research mode or non-technical stakeholders must sign off; suggested for image-extraction or ingestion provenance (the translation was never visually validated)

阅读完整来源 ↗