用途:在 Trace 尚未切分前,由设计师视角为整个功能产出完整设计,覆盖用户旅程。把每条用户故事映射到界面与状态,找出跨功能的共享组件,并把完整 Design Handoff 写入 Feature issue,为后续 wtf.feature-to-traces 生成更好的 Trace Plan、供 wtf.design-trace 复用功能级决策打基础。
主要能力:先做 GitHub CLI 安装与鉴权检查;识别 Feature(可用 issue 编号或从最近开启的 Feature issue 中选择),沿 Feature → Epic 层级提取用户故事、验收标准、Edge Case、领域事件,以及 Epic 的设计产物(Figma 链接或研究文档);做生命周期标签检查;加载 docs/steering/DESIGN.md 设计指引;用 Glob/Grep 并行探查现有组件、设计 token、Storybook 故事与 Figma 引用;为每条用户故事推导入口、正常路径界面、分支状态(加载、错误、空、部分数据、无权限)、出口,以及跨故事转场、Edge Case 界面和领域事件在 UI 中的呈现位置;询问设计资产处理方式。
设计资产三种路径:A 用户提供 Figma 帧,按旅程图做覆盖矩阵校验;B 通过 Figma MCP 的 generate_figma_design 生成设计(不可用时回退到 C);C 仅产出文本 brief(屏幕清单与组件映射,不依赖 Figma);另有 Partial 混合路径。之后识别共享组件(已有复用、新增共享、单屏专属),起草 Design Handoff,与用户确认后用 gh body helper 读改 Feature issue: python3 .wtf/gh-body.py read <feature_number> python3 .wtf/gh-body.py edit <feature_number> --body-file "<path-from-read>" 完成后在满足条件时打标签: gh issue edit <feature_number> --add-label "designed" 最后输出 Feature issue URL,并询问是否继续规划 Trace。
适用场景:需要为一个完整功能在切 Trace 之前做整体设计交接的设计师与团队。
限制:依赖 GitHub CLI 且需已鉴权;Figma 生成依赖 Figma MCP 工具可用,否则只能走文本 brief;仅覆盖资料所述流程,其余细节暂未提供。