用途:在 agent-swarm 的仪表盘 apps/ui 中构建或修改界面时使用,覆盖页面、组件、表单、设置页以及 onboarding 多步流程。使用前需先阅读 apps/ui/CLAUDE.md(基础组件目录、设计令牌、动效时序、DataGrid、PR 证据)与 apps/ui/DESIGN.md(视觉准则);若本技能规则与其冲突,以它们为准。
主要能力与规范:明确组件放置规则,多流程复用的部件放 components/ui/ 或 components/shared/,跨组件复用的 hook 放 hooks/,仅流程内使用的部件留在流程目录。规定依赖方向,基础与共享组件不得导入 onboarding 或 pages,hooks 不得导入 pages。提供基础组件目录(SegmentedControl、Kbd、SuggestionChips、BrandLogo、ModelLabel、ThemePresetPicker、SecretInput、StatusIcon、SaveIndicator、BorderBeam、InfoTip、AnimatedReveal 等)及各自适用场景。
使用方式:文本字段停止输入约 800ms 后自动保存,密钥不在输入时保存,需粘贴或焦点离开字段组且通过前缀长度校验后保存。每个字段只有一条保存链,失败时显示错误并在下次提交重试,不要调用 /api/config/reload。带跨字段校验的表单保留显式保存按钮。
动效与布局:仅动画 transform 与 opacity,遵循给定时序与布局约定,减少动态效果时保留淡入。交互上使用单一 window keydown 监听,处理阻止状态与提示。
验证:运行 cd apps/ui、bunx tsc -b、bun run lint、bun run check:tokens,并用 agent-browser 做截图与录制验证。限制:部分细节依赖项目内文档,未提供的内容以原文为准。