用途:在编写 UI 单元之前先确定结构,把辅助功能、国际化、打包成本、缺失状态等本应在审计阶段才暴露的问题提前决策。它是 codebase-design 的前端对应物,把组件视为深模块:以很小的 prop 表面承载大量行为。
主要能力:按四阶段推进。第一阶段分类工作,识别是设计系统基础组件、复合组件、页面/路由,还是既有 UI 重构,并确定侧重。第二阶段做决策:确定边界与 prop API,优先组合(children/slots)而非配置,警惕布尔标志泛滥;确定状态归属(局部→上提父级→服务端状态→URL,不重复存储派生状态);确定数据与异步的获取边界和缓存归属;枚举并设计必需状态(加载、空、错误、禁用,必要时部分/乐观更新);样式使用设计系统 token;移动优先的响应式;默认语义化 HTML 与键盘可操作性;用户可见字符串从一开始走国际化路径。第三阶段构建,接口保持浅、隐藏实现细节,非平凡逻辑交给 tdd。第四阶段有明确的完成定义与交接。
使用方式:这是知识/决策技能,不是代码生成器。先明确解决第二阶段的设计问题,再把实际实现交给 tdd/build,验证交给审计类技能;技能本身不手写完整组件或测试。
适用场景:设计系统基础组件、复合组件、页面/路由、既有 UI 重构的前期设计。
限制:与框架无关,除非代码库已使用某框架;仅限当前工作单元,不重设计无关组件;不重复各审计技能的检查清单;完整 WCAG 检查交由 a11y-audit,国际化交由 i18n,行为测试交由 tdd,真实浏览器前后对比交由 visual-validate。具体命令与安装方式暂未提供。