用途:为单个 UI 组件定义或修订契约,覆盖 props、变体、插槽、键盘与焦点行为、数据归属。在提出重复组件或通用抽象前,先检查现有组件与调用方。
主要能力:命名用途、使用方与归属(产品无关原语、领域组件或布局);定义必要输入、事件、受控/非受控行为、默认值与组合插槽;优先显式状态而非互相矛盾的布尔组合;区分组件行为与服务端授权、持久化职责;描述原生语义、可访问名称、键盘模型、焦点进入/返回与反馈;定义内容限制、换行、响应式行为、支持主题与 token 使用;修订时先识别调用方迁移与向后兼容。
使用方式:产出紧凑契约,包含用途/归属、API、有意义状态、交互、韧性与验收标准;仅在类型能消除歧义时包含类型。模板含 Purpose、Type、Used in、Variants、States、Props、Accessibility、Tokens/responsive、Acceptance。在真实父级中验证行为,包括长内容与键盘交互;实现请求需构建组件并运行相关检查。
适用场景:定义组件 API、审查组件契约、修订现有组件契约。
限制:不用于定义 token 角色或主题配对(用 $tokens);不用于查找组件库中的重复或漂移(用 $system);不用于审计屏幕缺失的加载、空或错误状态(用 $states)。缺失 token 不是阻塞项,可命名组件所需角色。简单徽章无需完整组件 RFC。