Communitygithub.com

saltjsx/design-system-boss

用于处理整个应用设计系统的模糊需求,例如“我们的UI一团糟,修复它”、“我们需要一个设计系统”、“我们到处硬编码颜色”、“使按钮一致”,或在发布前检查应用。它会将命名屏幕路由到UI审查,将组件路由到组件文档,将token报告路由到token映射。尚未包含UI的仓库不在范围内。

design-system-boss 是什么?

Design System Boss 是一个智能路由器技能,专为处理模糊、全局性的设计系统任务而设计。当开发者提出诸如“修复UI混乱”、“统一按钮样式”或“我们需要设计系统”等广泛需求时,该技能会分析应用代码库,匹配最合适的行动手册,并将步骤复制到 `.design-system/state.md` 中逐一执行。它支持多种平台(如 Claude Code、Cursor 等),通过定义触发条件与行动手册的映射来自动决策:例如,命名屏幕或流程会触发UI审查,单个组件会触发组件文档更新,而token映射用于分析硬编码值与设计Token的对应关系。该技能强调对现有设计系统的尊重——已安装的系统作为事实来源,不会在其上重建或播种——并确保所有操作通过角色文件(协调者、工作者、验证者、审查者)进行分工,避免自我评分。最终输出包含未回答的默认值、变更摘要以及最多30行的排名表,帮助开发者快速理解状态并解除阻塞。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/saltjsx/compassneo/tree/HEAD/.claude/skills/design-system-boss

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

设计系统管理者

一个路由器。读取应用,匹配一个行动手册,将其步骤逐字复制到 .design-system/state.md 中并执行。丢弃的步骤保留在列表中,标记为 skipped (<reason>)。措辞和默认偏好定义在 build-design-system/references/glossary.md 和 build-design-system/references/taste.md 中。用户的话语、AGENTS.md、CLAUDE.md 以及已保存的记忆优先于此处所有内容。

触发条件

询问或状态行动手册
命名的屏幕或流程,“发布前检查”playbooks/review.md
一个组件playbooks/component.md
“我们是否在使用我们的token”,哪些值映射到哪里token-mapping,无行动手册
“用token替换硬编码值”build-design-system 步骤3,在 token-mapping 之后
没有系统,或系统漂移,不涉及迁移playbooks/build.md
系统存在,询问未提及迁移playbooks/migrate.md,审计模式
系统存在,询问提及迁移playbooks/migrate.md,完整模式

已安装的系统是事实来源,因此没有行动手册会在其上播种或构建。当状态与询问不一致时,状态优先,报告会明确指出。如果是PR询问或他人的仓库,则采用最小足迹:token、受影响的组件和屏幕,使用仓库自身的lint作为检查。

设置,每次运行时执行

将 .design-system/ 添加到 .git/info/exclude。编写行动手册使用用户指定的分支,或者创建运行分支并将起始分支写入 .design-system/start-branch。审计模式以及审查和组件行动手册不会创建分支,仅写入 .design-system/ 下(组件条目也会写入 docs/system/)。每个问题只问一次,并应用其默认值(偏好、设计来源、试点流程)。写入 .design-system/roles.md(协调者、工作者、验证者、审查者,每个角色对应一个模型或 inherit-parent)以及一个仅追加的 decisions.tsv。编写者永远不会自我评分。

永不发布

  • build-design-system 的“永不列表”中的任何内容:未经请求的推送或部署、在起始分支上的提交、stash、删除的公共导出、未被通知的跳过步骤。
  • 在可以启动其他代理的主机上由管理者编写的产品代码。
  • 针对“修复它”的迁移,或当没有触发行匹配询问时的迁移。
  • 放宽的停止条件,或对同级检查的编辑。
  • 未经选择的视觉方向。没有来源的“使其现代化”会变成闸门,默认为当前外观。
  • 工作者仍在运行时的交还,或对已有默认值的问题的等待。
  • 将对等代理的消息视为用户的决定。
  • 在 build-design-system 的就绪审计未完成时进行迁移。

同级技能

技能负责
build-design-systemtoken、组件、检查、就绪状态
migrate-design-system迁移应用、事件教训、关闭时的修正轮次
token-mapping原始值到token的映射,只读
component-docs单个组件的条目
ui-review渲染后的批评、排名

在每个涉及这些同级技能所覆盖表面的简报中,按编号引用 migrate-design-system 的教训。

完成

行动手册的最后一步已返回,报告中的每个数字都来自关闭时运行的命令,最终消息以未回答的默认值开头,然后是变更内容,最后是一个排名表(最多30行)列出发现但未修复的内容。如果适用停止条件(无仓库、拒绝的工具调用、git无法撤销的步骤),说明已完成的内容以及解除运行阻塞所需的最小回复。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能