SuperAPI AI 工具集

temps-design-system

设计与创作

查看项目

更新于 10-15 21:54

技能介绍

用途:为 Temps 控制台界面建立统一的视觉与结构规范。两套文档各司其职:仓库根目录的 DESIGN.md 是 web/src 现状的权威参考(全宽页面、紧凑空状态、共享表格与分页、shadcn 控件);web/packages/ds/docs/RULES.md 将相同约定固化为真实包 @temps-sdk/ds,含模板、token 流水线与 lint 检查。构建或评审前需先读 RULES.md、brand-guidelines.md 和 design-system-handoff.md。

分类流程(数据形态决定模板):同构集合(项目、部署、日志、告警)用 Ledger,含列、行、可选工具栏与分页;单个对象详情用 Detail,遵循记录配方:标题、判定状态徽章、4–6 条键值事实、主栏、侧栏;用户提交的输入(设置、引导向导)用 Settings,由 Field/FormErrors 构成;无法干净归类的仪表盘或自定义可视化不要强套模板,应直接组合 PageHeader、Status、TimeChart、Callout 等原语并在 PR 说明。尚无数据时用 PageState 的 not-set-up 变体,展示界面、说明缺什么、给出具体示例并链接设置页。

控件规则:暂不可用的控件须看起来无效,而非仅 disabled。Button 的 busy/busyLabel 在操作中不设原生 disabled,改用 aria-disabled 加点击守卫;EchoDialog 确认按钮同理,用于不可逆操作。

命令:在 web/packages/ds 下运行 bun run lint(类型检查、tokens:check、audit:records)、bun run tokens:build、bun run tokens:check、bun run audit:records --dir src;在 design-system 下运行 bun run build。新增原语前先查 design-system-handoff.md 的原语目录,确为新增则放在 web/packages/ds/src/ 并从 src/index.ts 导出,复用已有应用代码,加入 design-system 画廊演示,更新目录表与 RULES.md,提交前跑 lint。

范围与限制:生产迁移 web/src 仅部分完成,不要顺手迁移既有界面,编号后续项在 handoff 中跟踪。机器检查覆盖 token 一致性、禁止原始 hex/oklch/px/ms、TypeScript 类型;记录配方顺序、文案具体性、状态色用途与模板选择靠人工评审。沙箱示例须可交互。评审参考 better-ui、emil-design-eng、design-system-patterns、extract-design-system;本地控制台审计用 agent-browser 测量计算样式,记录路由、主题、视口与采样限制,不得采集凭据或客户记录。测量结果与规范 token 分开,既有决策与 RULES 优先。不要引用已删除的 operator ink 原型。