关于 design-system-boss
design-system-boss 是用于规划和跟踪仓库中设计系统工作的协调技能。它依据仓库状态分派给相关技能,记录检查结果,并据文件生成交接报告。
主要功能
- 01根据仓库信号和意图选择流程
- 02协调相关设计系统技能
- 03在状态文件中跟踪步骤与结论
- 04检查证据及干净克隆结果
- 05依据文件生成交接报告
适用场景
- 01开始设计系统工作前分流仓库
- 02协调设计系统构建或审查
- 03跟踪迁移授权及待处理问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ arla6ka/ skills --skill design-system-boss安装后在 Claude Code 中输入/design-system-boss确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdTESTS.mdreferences/coordinator-path.mddelegation.mdroutes.mdstate.mdtriage.mdscripts/triage.sh详细介绍
设计系统负责人
- 如果
.design-system/boss/state.md存在,从该文件恢复(references/state.md,Resuming)。否则运行scripts/triage.sh(references/triage.md)。 - 根据各项信号确定状态、意图和基础(
references/triage.md)。如果small_app yes,走快速路径(references/routes.md,Small app)。 - 从下表选择路径。除非请求中明确指定迁移,否则路径以先检查结束(
references/routes.md,顶部的规则)。 - 选择运行分支,设置阶段上限,探测宿主,并写入状态文件(
references/coordinator-path.md,第 6 至 9 步)。 - 发送已应用所有默认值的 Frame。未回答的问题保留其默认值,并标记为
default (unanswered),然后继续运行(references/triage.md,The one question)。 - 通过子 Agent 执行路径的各个步骤,每次只执行一个写入步骤(
references/delegation.md)。写入任何文档前,先落实已确定的默认值。 - 检查每项返回涉及的文件,并记录结论(
references/delegation.md,Checking a return)。 - 收尾:再次分诊,执行干净克隆检查,保存截图,然后填写
close.md和一张未修复问题表(references/state.md)。 - 最终消息发送 Report 部分,先列出未回答问题的默认值,并附上迁移选项及其规模。
绝不交付:
- 在能够启动子 Agent 的宿主上,由负责人编写的产品代码。
- 未获许可就超出安全操作范围的迁移;也不能把“修复它”视为许可。
- 已确定的默认值落实前提交的文档或规范。
- 未经任何人通过设计来源问题选择的新视觉方向。
- 报告中没有对应
close.md行的数字。 - 工作人员仍在运行时进行的交接。
- 对已有默认值的问题停下来等待答案。
当负责人以子 Agent 身份运行时,应以前台调用方式启动工作者,并在一条消息中同时启动多个工作者,让它们并行执行;绝不能在后台工作者仍在运行时结束当前轮次。仍在运行的工作者会继续向无人检查的代码库写入内容。
五个同级技能负责执行工作:build-design-system、migrate-design-system、token-mapping、ui-review 和 component-docs,每个都通过其“When a coordinator calls it”部分调用。同级技能的路径从 <skills> 开始。build-design-system/references/run-record.md(Terms)定义了 surface、gate、clearance 和各状态词的含义;其中的常设指令同样约束负责人。先阅读 references/coordinator-path.md,其中列出了每个步骤以及需要打开的文件。
输出
只有在路径的最后一步已返回、每个步骤在 .design-system/boss/state.md 中都有状态和结论,并且报告根据文件编写后,才算完成。可核查项:
triage/signals.tsv和triage/after/signals.tsv均由scripts/triage.sh生成;所选路径与路由表一致,或者有一条决策记录说明为何不同。- 每个步骤都有结论,并注明可证明该结论的文件。报告中的每个数字都必须对应
close.md中的一行,并注明单位和来源。 - 所有同级记录中的 gate 都已列入状态文件的 Gates 表(
references/state.md,The state file),所有未回答项均标记为default (unanswered)。 - 对于写入类路径,在运行分支的干净克隆上执行检查并以 0 退出;或者,仓库自身的 lint、typecheck 和 build 在最小占用下均通过。每个变更后的 surface 都有截图和 montage 行;每项值相同的替换都有证明;每个试点陷阱都已通过数字修复,或通过测量设置 gate。已保存
git status的前后状态,.design-system/tmp/已删除,所有未跟踪路径均已提交,或在决策记录中列明。 - 报告以一张 Found, not fixed 表格结尾,按优先级排序,最多 30 行。
最终聊天消息必须与状态文件的 Report 部分完全一致(references/state.md,The handoff report)。如果满足以下任一停止条件,则返回该条件、已完成内容、状态文件路径,以及解除阻塞所需的最简回复,例如“请指出使用哪个应用:apps/web 还是 apps/admin。”
输入
| 输入 | 缺失时的处理 |
|---|---|
| 请求 | 必填。“我们的 UI 一团糟”就够了 |
| 仓库 | 没有就停止。只读访问权限仅允许执行 Audit 和 Review |
| 目标应用(位于 monorepo 中) | 这是唯一需要提问的问题;默认选择路由最多的应用。与此同时,梳理每个应用 |
| 意图 | 根据请求中的措辞,参照 references/triage.md |
| 预算 | Frame 的 Go, <budget> 回复;否则使用宿主的会话时长;再否则为 2 小时,并按照 references/routes.md(Budget)分配 |
| 同级技能 | 位于 <skills> 中。缺少某项时,只跳过该项对应的步骤,并在报告中注明 |
| 子 Agent、浏览器、Shell | 按 references/delegation.md 探查 |
| AGENTS.md 或 CLAUDE.md、当事人的原话、已保存的记忆 | 它们优先于所有技能默认设置,包括分支和推送策略。 “在我当前的分支上工作”意味着使用当前分支运行。将这些内容纳入每份任务说明 |
明确迁移授权
只有请求明确提及迁移,或对交接时的提议作出回复(build-design-system/references/run-record.md,Terms),才算获得迁移授权。兜底意图和“修一下”之类的抱怨都不算。获得授权后,只有在迁移编辑之前,重新固定其审计 plan.md 并与构建的 registry.json 核对一致,且迁移的滚动窗口在机器预算内对互不重叠的路径运行,才能进行迁移。未获得授权时,流程以 check-first 结束。运行中提出的请求按 references/routes.md(顶部规则)处理。
路由表
状态、弱和意图取自 references/triage.md。references/routes.md 列出了每条路由的步骤。逐字复制这些步骤,并将已省略的步骤标记为 skipped (<reason>)。
| 状态 | 意图 | 路由 |
|---|---|---|
| 已安装 | review | Review,以已安装系统的 SKILL.md 作为评判标准。优先于下方所有行 |
| 已安装 | audit | Audit,以已安装系统为目标 |
| 已安装 | 其他任意意图 | 已安装系统 |
| 系统仓库 | review、audit、component | 对应意图的下方路由 |
| 系统仓库 | 其他任意意图 | 系统仓库 |
| 空 | 任意 | Seed |
| 无,或正在漂移且不弱 | build | Build |
| 正在漂移,弱 | build | Harden,在 Frame 中注明 |
| 任意,且请求中提及 PR 或上游 | 指定系列 | 指定系列,最小改动范围。优先于下方所有行 |
| 正在漂移或已稳定,弱 | full、harden、adopt | 先执行 Harden,再从第 5 步开始执行 Full。若意图为 values,则先执行 Values。优先于后续行 |
| 无,正在漂移或已稳定,不弱 | harden | Harden。若没有 harden_dirs,则执行 Build |
| 无或正在漂移,不弱 | full | Full |
| 已稳定或有文档记录,不弱 | full、adopt | Adopt |
| 正在漂移,不弱 | values | Values |
| 已稳定 | docs | Document |
| 任意 | component | Component |
| 任意 | review | Review |
| 任意 | audit | Audit |
已安装系统是事实来源,因此任何路由都不会在其上进行 Seed、Build 或 Harden。只有为其所有者记录差距后,才能扩展该系统(references/triage.md,The installed system)。请求提及 PR 或上游,或仓库看起来属于他人时,路由将以 <route>, minimal footprint 形式运行(Footprint,见 run-record Terms)。当请求与状态不一致时,以状态为准,并由 Frame 说明。“迁移我们”在状态为 none 时对应 Build。
边界
可以决定路线、运行分支、阶段划分、哪些只读步骤并行运行、对失败步骤重试一次、为需求中未说明的同级输入采用默认值,以及在输出仍为最新时跳过某个步骤并引用其记录。
应用默认值后询问,并继续:
- 在写入路线中遇到有未提交更改的检出,或他人的分支。默认值:从 HEAD 在独立工作树中使用运行分支,以保持检出状态不变。绝不暂存更改。
- 在会写入的路线中仅具备只读访问权限。默认值:Audit。
只有在没有仓库,或同级步骤返回其停止格式且下一步需要其输出时,才停止。
绝不放宽同级步骤的判定条件,也不编辑同级技能。“让它更现代”但没有设计来源时,应设为一道关卡,默认值为“保持当前外观”(references/triage.md,常见问题)。