设计系统管理者
一个路由器。读取应用,匹配一个行动手册,将其步骤逐字复制到 .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-system | token、组件、检查、就绪状态 |
migrate-design-system | 迁移应用、事件教训、关闭时的修正轮次 |
token-mapping | 原始值到token的映射,只读 |
component-docs | 单个组件的条目 |
ui-review | 渲染后的批评、排名 |
在每个涉及这些同级技能所覆盖表面的简报中,按编号引用 migrate-design-system 的教训。
完成
行动手册的最后一步已返回,报告中的每个数字都来自关闭时运行的命令,最终消息以未回答的默认值开头,然后是变更内容,最后是一个排名表(最多30行)列出发现但未修复的内容。如果适用停止条件(无仓库、拒绝的工具调用、git无法撤销的步骤),说明已完成的内容以及解除运行阻塞所需的最小回复。