component-spec 是把一个库组件说明成可实现规格的 Skill。它写清组成、参数、变体、状态和使用规则,让设计与开发共享同一行为约定。
一张按钮图看不出加载时是否允许再点,禁用时能否获得焦点,以及错误发生以后怎么恢复。参数的默认值与必填条件也要和这些状态一致,避免文档各处互相矛盾。
提供组件目的、设计和交互条件,它能组织规格及示例。鼠标、触摸与键盘不能只列名字,要说明真实动作与反馈;ARIA 标签也不能代替正确语义和实际测试。规格覆盖多个状态不等于实现已经覆盖,后续验收仍要逐项对应。