build-design-system 是一个用于构建设计系统的 AI 技能，名称和标识为 build-design-system（来源 arla6ka/design.how）。其核心用途是：当有人提出设计系统工作中的某一阶段任务时（例如“从应用中提取令牌”或“为 Button 补充状态和规格”），或面对空仓库时，启动一次结构化的设计系统构建运行。
用途与流程：该技能按阶段推进。首先进行框架设定（Frame），读取代理指令、清单、样式入口、主题提供者和路由树，记录用户诉求、首个可见改动、带空白计数的谓词和常设命令，设置视口（默认 390 和 1280 像素），初始化足迹并运行 node scripts/check-system.mjs --init。随后进行界面盘点（Inventory），用脚本列出每个界面及其状态和层级，并用 capture.mjs --kind before 命令截图；记录动画列表并测量试点陷阱，按家族分组、标记重复项，删除无使用项需单独提交。基础阶段（Foundations）将原始值按类别和角色聚类为语义令牌，含表面与前景配对；容差内的合并作为决策，超出容差则按簇开启默认值为合并的闸门。组件阶段（Components）按契约选择规范实现，先端到端构建最常用家族（组件、测试、展示页和规格），再分发其余家族；弃用被替换的包装器，但绝不弃用基础组件。检查阶段（Checks）需在干净克隆上退出 0，且每条新增规则都需在本会话中见到其失败。试点与安全改动阶段（Pilot, then safe moves）用 codemod 移动试点并逐块阅读，之后用基线视口、主题和数据截图；未追踪的差异视为缺陷。文档阶段（Docs）为缺少规格的规范组件运行 component-docs，编写基础页面、共享状态模式和写作页面，运行 node scripts/gen-docs.mjs 并加入 copy-check.mjs。交接阶段（Handoff）重跑盘点脚本，给每个组件评分并填写谓词，运行新代理试验并收尾。
主要能力：该技能强调“绝不交付”清单，包括：不交付应用没有的颜色、字体、阴影、渐变或动效值（除非用户选择设计源并确认样本）；不在起始分支提交、推送、发布或部署；不编辑基线、夹具或检查（应改代码）；不进行试点外既非安全改动也未经批准的改动；不从未渲染输出读取无障碍或对比度结果；不报告未经脚本产生的计数或从未见过失败的检查。它还定义了边界：仅在无仓库访问、删除影响其他包或公共 API 导出、git 无法撤销的步骤（如发布包或更改共享远程）时停止并询问；对于有默认值的闸门（如品牌颜色、产品词名称、超出容差的合并、代码与规格冲突、链接颜色或下划线改动）应继续工作。
使用方式：需要 shell、git 和 Node 环境。输入包括仓库写入权限（缺失则停止）、运行应用的方式（尝试 dev 或 start 脚本；若无法启动，则从代码运行第 3、4、5、7 阶段，跳过试点并报告“code-complete, not runtime-verified”）、单仓库中的目标应用、试点流程、预算、主题、模式与基础、现有令牌/库/设计规格/品牌，以及用户话语和保存记忆、AGENTS.md、CLAUDE.md（优先于本文件，包括分支和推送策略）。技能会从仓库或默认值填充输入，不询问路径。
适用场景：适用于已有代码仓库的设计系统建设、令牌提取、组件状态与规格补充、试点流程迁移、设计系统文档生成与交接。限制：必须基于现有应用代码而非截图；需要可运行应用或至少可从代码完成部分阶段；不允许未经授权的外部发布或共享远程变更；缺失事实需明确标注。