用途:为 Figma 组件的描述字段撰写结构化说明,供 LLM 经 Figma MCP 读取,使 AI 代理能理解、组合并生成该组件。输出采用六段式(PURPOSE、PROPS、ANTI-PATTERNS、COMPOSITION、ACCESSIBILITY、EXAMPLES),为纯文本连续段落,避免嵌套列表,总长约 300 至 600 词,便于控制 token 预算。
主要能力:从可用数据源收集事实,包括 .ai/metadata 元数据、Figma 节点与变体、Storybook 故事元数据、源码(TypeScript/PropTypes、渲染元素、ARIA、按键与焦点调用)。Step 1 汇总组件名称、分类、属性与变体及取值、默认状态、组合关系、无障碍要求与已知误用。Step 2 逐段撰写;属性按“prop 名; 类型; 默认值; 说明”每行一条;反模式列出三至五条针对该组件的禁令,无法确认的标为 anticipated;无障碍部分须具体到语义元素、键盘模式、焦点管理与 aria 属性,无法确认的标为 unverified。Step 2b 做去重收紧。Step 4 以“只有该描述时 LLM 能否选型、配置、避坑、判断放置、无障碍使用、区分近似组件、生成正确示例”进行自测。
使用方式:若存在 .ds-ops-config.yml 则按配置读取 figma、storybook、github、documentation 等来源。Figma MCP 只读取当前选中节点或节点链接,无返回时需用户选中组件或粘贴节点链接。若组件描述字段已有内容,须先引用并询问是重写、改进还是重来。若连接了具备写权限的 Figma MCP,可回写描述(如 figma_set_description 或 use_figma),写入前展示全文并确认替换内容,写后读回校验。
限制:缺少任何数据源时应停止并索取,不能凭记忆编写;配置源报错只记录并继续,不循环重试。所有属性、默认值、ARIA、按键与焦点行为须可溯源,否则标为 unverified。该技能仅产出散文描述,不产出机器可读 JSON 元数据。技能前置引用文件缺失时提示按 1-INSTALL.md 重装并运行 verify-install.sh;若用户明确要求在缺参考资料下继续,须在输出中注明。