SuperAPI AI 工具集

curate-carbon-component

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

用途:该技能用于整理或审核一个 Carbon React 组件的已编写技能元数据和面向智能体的 Storybook 示例。适用于扩展组件技能覆盖范围或复核示例。

使用方式:修改前先阅读 docs/component-metadata/README.md,它定义了事实来源划分、元数据字段、示例标准与完成检查。除非用户要求更大范围,任务应聚焦于一个活跃组件。若未选定组件,运行 npm run skills:status 并从等待审核的活跃组件中选择;除非确需迁移指引,不要为已弃用组件投入覆盖工作。编写元数据前,检查组件源码、Storybook stories 与 MDX 以及当前生成的组件文件。Carbon 源码与 Storybook 是主要面向开发者的来源;元数据可压缩它们或添加经审核的 Fusion 指引,但 Fusion 不是前置条件。不要从 prop 名称推断指引、不要与公开组件行为矛盾、不要把设计建议呈现为强制技术约束。只添加会改变智能体决策的指引;可选字段宁缺勿重复摘要或填充模板。

主要限制:保持能力与设计决策分离;说明 props 与视觉变体启用什么以及技术约束,而不规定设计师何时选用。保留经审核指引是建议还是要求。仅当组件选择、无障碍、实现正确性或明确要求需要时才写规定性指引。整理少量聚焦且对使用者有用的 stories,不要整理 playground stories 或使用已弃用 API 的示例。必要时改进提取器或源 story,而不是仅为提取而改写。若所选示例不完整或不可访问,修正源 story 使 Storybook 与技能保持一致。

禁止直接编辑 skills/carbon-react/。运行 npm run build:skills,检查生成的组件及每个关联示例,然后运行 npm run test:skills、npm run build:skills -- --check、npm run type-check。仅当生成的指引简洁、导入与 props 最新、弃用情况准确、示例脱离 Storybook 上下文仍可理解且检查通过时才算完成。