用途:Design To Code 用于按已批准的设计工单构建屏幕,每个构建工单执行一次。适用于屏幕存在设计工单的任何 UI 工单。输入是一个已批准的设计及其状态渲染,输出是用现有基础组件、围绕派生视图模型(纯 derive(facts))组装出的屏幕,以及一份说明哪些组件抽取确实有理由的清单。设计被视为一次性规格而非源码:其决策以 token 和清单行的形式保留,标记本身不保留。
主要能力与用法:先读 docs/design-stack.md,它回答四个问题——token 契约位置、组件位置及位置选择方式、隔离状态机制、状态渲染方式;文件缺失则据仓库作答并在报告中说明,建议运行 /setup-design-infra。确认设计工单为最新(若标为 stale 需先 re-base),自上而下用 kit 基础组件、已有共享原子和视图模型组装屏幕骨架。仅当出现重复标记、设计系统跨屏复用单元(卡片、徽章、状态、空态、抽屉头)或存在未被 happy path 覆盖的状态时,才抽取为具名组件,否则保持内联。抽取后在构建工单上以注释写下清单,每行含 name、tier、location、props、composed-of,并向用户展示清单与内联区块以获得确认。随后按目标仓库规则加固每个抽取组件,放置隔离状态用例与屏幕级用例,跑通 lint、测试、无原始值检查,再运行 pixel-review,在同一变更中修正分歧。最后在 PR 合并后关闭设计工单(仅当其为最后一个子问题时),并指明完成屏幕的提交。
读取设计的命令:git fetch origin 'design/#<N>-<screen>';git show FETCH_HEAD:design.html > "$TMPDIR/<screen>.html"。需用 FETCH_HEAD 而非分支名。分支已被清理说明流程正常、屏幕已发布,此时工单即为完整规格。
限制:收费、价格、平台支持等资料暂未提供。关闭设计工单须在 PR 合并后进行,否则评审阶段的 pixel 修改会失去设计页。