mcpField
D
design-system-boss

design-system-boss

github.com/arla6ka设计与 UI221241 次安装4 天前更新
代码仓库

关于 design-system-boss

design-system-boss 是用于规划和跟踪仓库中设计系统工作的协调技能。它依据仓库状态分派给相关技能,记录检查结果,并据文件生成交接报告。

主要功能

  1. 01根据仓库信号和意图选择流程
  2. 02协调相关设计系统技能
  3. 03在状态文件中跟踪步骤与结论
  4. 04检查证据及干净克隆结果
  5. 05依据文件生成交接报告

适用场景

  1. 01开始设计系统工作前分流仓库
  2. 02协调设计系统构建或审查
  3. 03跟踪迁移授权及待处理问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/arla6ka/skills --skill design-system-boss

安装后在 Claude Code 中输入/design-system-boss确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
TESTS.md
references/
coordinator-path.md
delegation.md
routes.md
state.md
triage.md
scripts/
triage.sh

详细介绍

设计系统负责人

  1. 如果 .design-system/boss/state.md 存在,从该文件恢复(references/state.md,Resuming)。否则运行 scripts/triage.sh(references/triage.md)。
  2. 根据各项信号确定状态、意图和基础(references/triage.md)。如果 small_app yes,走快速路径(references/routes.md,Small app)。
  3. 从下表选择路径。除非请求中明确指定迁移,否则路径以先检查结束(references/routes.md,顶部的规则)。
  4. 选择运行分支,设置阶段上限,探测宿主,并写入状态文件(references/coordinator-path.md,第 6 至 9 步)。
  5. 发送已应用所有默认值的 Frame。未回答的问题保留其默认值,并标记为 default (unanswered),然后继续运行(references/triage.md,The one question)。
  6. 通过子 Agent 执行路径的各个步骤,每次只执行一个写入步骤(references/delegation.md)。写入任何文档前,先落实已确定的默认值。
  7. 检查每项返回涉及的文件,并记录结论(references/delegation.md,Checking a return)。
  8. 收尾:再次分诊,执行干净克隆检查,保存截图,然后填写 close.md 和一张未修复问题表(references/state.md)。
  9. 最终消息发送 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>)。

状态意图路由
已安装reviewReview,以已安装系统的 SKILL.md 作为评判标准。优先于下方所有行
已安装auditAudit,以已安装系统为目标
已安装其他任意意图已安装系统
系统仓库review、audit、component对应意图的下方路由
系统仓库其他任意意图系统仓库
空任意Seed
无,或正在漂移且不弱buildBuild
正在漂移,弱buildHarden,在 Frame 中注明
任意,且请求中提及 PR 或上游指定系列指定系列,最小改动范围。优先于下方所有行
正在漂移或已稳定,弱full、harden、adopt先执行 Harden,再从第 5 步开始执行 Full。若意图为 values,则先执行 Values。优先于后续行
无,正在漂移或已稳定,不弱hardenHarden。若没有 harden_dirs,则执行 Build
无或正在漂移,不弱fullFull
已稳定或有文档记录,不弱full、adoptAdopt
正在漂移,不弱valuesValues
已稳定docsDocument
任意componentComponent
任意reviewReview
任意auditAudit

已安装系统是事实来源,因此任何路由都不会在其上进行 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,常见问题)。

评论

支持 Markdown