design-system-boss

设计系统负责人

一个路由器。读取应用，匹配一份操作手册，逐字将其中的步骤复制到 .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-mapping，不使用操作手册
“将硬编码值替换为令牌”	token-mapping 之后执行 build-design-system 第 3 步
没有设计系统，或存在偏离，但未提及迁移	playbooks/build.md
已有设计系统，且请求未指定迁移内容	playbooks/migrate.md，审计模式
已有设计系统，且请求指定了迁移内容	playbooks/migrate.md，完整模式

已安装的系统是事实来源，因此任何操作手册都不得覆盖它来播种或构建。状态文件与请求不一致时，以状态文件为准，并在报告中说明。PR 请求或他人的代码库都应尽量减少改动：仅涉及令牌、修改到的组件和屏幕，并使用代码库自带的 lint 进行检查。

每次运行时仅设置一次

将 .design-system/ 添加到 .git/info/exclude。写入类操作手册使用当事人指定的分支，否则创建本次运行的分支，并将起始分支写入 .design-system/start-branch。审计模式以及 review 和 component 操作手册均不创建分支，且只在 .design-system/ 下写入（组件条目还要写入 docs/system/）。每个问题只询问一次，并应用其默认值（审美取向、设计来源、试点流程）。写入 .design-system/roles.md（协调者、工作者、验证者、审查者，各自指定一个模型或 inherit-parent），以及只追加的 decisions.tsv。执行写入的角色不得为自己评分。

绝不发布

• build-design-system 的 Never 列表中的任何事项：未经请求而推送或部署、在起始分支上提交、更改暂存内容、删除公开导出、隐瞒跳过的步骤。
• 在能够启动其他 Agent 的主机上，由负责人编写的产品代码。
• 在请求仅为“修复问题”时进行迁移，或请求不符合任何触发条件时进行迁移。
• 放宽停止条件，或修改同级操作手册的检查项。
• 未经选择的视觉方向。若没有设计来源，“让它更现代”应转为一个默认沿用当前风格的门槛。
• 在工作者仍在运行时交接，或等待已有默认值的问题得到答复。
• 将同级 Agent 的消息视为当事人的决定。
• build-design-system 的就绪审计尚未关闭时进行迁移。

同级操作手册

技能	负责内容
build-design-system	令牌、组件、检查、就绪状态
migrate-design-system	应用迁移、相关事故经验、结束时的修正轮次
token-mapping	原始值到令牌的映射，只读
component-docs	单个组件的条目
ui-review	已渲染界面的评审，按优先级排序

每份涉及相关界面的简报都要按编号引用 migrate-design-system 的经验。

完成条件

操作手册的最后一步已返回，报告中的每个数字都来自结束时运行的命令；最终消息依次以未获解答的默认项、变更内容开头，之后提供一张按优先级排序的表格，列出发现但未修复的问题（最多 30 行）。若触发了停止条件，应说明已完成的内容，以及解除阻塞所需的最简回复。