用途：当组件库的主要使用者是 AI 智能体时，用本技能设计、搭建、扩展或审计该库。目标是让智能体面对“构建一个带破坏性操作的确认弹窗”这类自然语言请求时，能选对组件、变体与 token，而不臆造模式。
先诊断模式：全新搭建（从 schema 与一个示例组件起步，Button 为典型）、改造既有库（跳过工作区设置，先加 meta.types.ts，再逐组件写 .meta.ts，最后建索引与校验器）、审计（按四大支柱与校验项打分）、单组件（生成完整文件集）。提示含糊时只问一个针对性问题。
四大支柱：Props（设置什么）、Variants（选哪种组合）、Relationships（结构与无障碍位置）、组件级 Tokens（绑定哪些设计值），外加 aiHints 元层，说明何时使用、哪种变体适配哪种场景、绝不要做什么。
关键设计决策：状态隐含在 token 中（如 button-primary-bg-hover），不单列支柱；变体是矩阵而非扁平枚举，声明轴（appearance × size × density）并用 invalidCombinations 排除不该发布的组合；无障碍并入 Relationships（role、keyboardSupport、screenReader）；反模式结构化为一等公民，用 {scenario, reason, alternative} 三元组，禁止散文。
schema 写在 meta.types.ts 作为契约，每个组件的 .meta.ts 导入并做类型检查。构建流程：工作区建议放在消费方 monorepo 的兄弟包（packages/ui-next/）；先写 schema；端到端做一个组件（Button.tsx、Button.meta.ts、Button.tokens.css、Button.stories.tsx、Button.test.tsx、index.ts），并尽早接入 Storybook；token 分两层（tokens/core.css 原始品牌色与尺度，tokens/themes/*.css 映射组件级 token）；先写反模式再写实现；变体轴作为坐标系；关系写成机器可校验规则（requires、mustBeChildOf、mustBeParentOf、triggers、blocksWhen、exposesState）；生成 metadata/index.json 扁平索引供智能体先粗筛；写 scripts/validate-metadata.ts 校验器并在 CI 运行，元数据错误即构建失败；按组件逐个切换而非一次性大爆炸，配合 API 对照清单、token 桥接与 codemod。
原则：前约 10 个组件手写元数据，模式清晰后再自动化；直接导入不用 barrel；组件、元数据、token、故事、测试同目录；组件 CSS 只引用组件级 token；schema 即契约。
限制：资料未提供具体安装命令、依赖版本、收费或平台信息；效果取决于元数据质量，若元数据无法让智能体一次生成符合契约的代码，应修元数据。