SuperAPI AI 工具集

cds-code

前端与建站

查看项目

更新于 10-16 01:27

技能介绍

用途:为 React 与 React Native 项目提供使用 Coinbase Design System(CDS)构建与审查 UI 的工作流。收到请求时先判断类型:创建或修改视觉 UI 归为 Coding,显式要求审计或检查现有代码是否符合 CDS 归为 Review(改读 guidelines/code-review.md),业务逻辑、数据处理、分析、导航接线、测试、生成代码或重构等非视觉工作不在范围内,默认按 Coding 处理。

初始化:每会话先运行 scripts/discover-cds-packages.sh,其输出确定 CDS Runtime(web 或 mobile,用作 CDS MCP server 的 platform 参数)以及已安装 CDS 包的名称、版本和有效导出子路径(导入时仅允许这些路径)。脚本不可用时,可查看源码中现有 CDS 导入推断平台,并读取 node_modules 中 CDS 包 package.json 的 exports 字段获取有效导入路径。

Coding 流程:必须先完成前两步再写代码。第 1 步准备文档,激活 cds-docs 技能,或调用 CDS MCP server 的 list-cds-routes,再按检测到的平台阅读 getting-started/styling 与 getting-started/theming。第 2 步用 guidelines/components.md 识别合适组件;涉及图标或插画时另读 guidelines/icons.md、guidelines/illustrations.md;若无合适 CDS 组件,按优先级依次使用项目内可复用 React 组件、以 CDS 原语自建组件、最后才用原生 JSX 元素,并在进入第 3 步前告知用户计划使用的组件。第 3 步可选阅读所用组件文档,无法获取时可参考发布类型定义了解 props API。第 4 步编写代码,包名与现有导入的 scope 保持一致,避免内联样式对象或 CSS className,优先使用 style props(如 color、font、textAlign、textTransform、gap、padding、background,或用 VStack/Box 的 flexDirection),以保持与 CDS 主题的关联。第 5 步校验:不得出现原始 rgb/hex 颜色、间距(padding、margin、gap、border radius)的原始像素值、已弃用的 CDS 组件或 hook 导入,所有导入路径须为初始化确认的有效导出,且 lint/类型检查/格式化任务通过。

限制:仅适用于 CDS UI 相关工作;对非视觉任务不使用该技能的编码或审查流程;文档不可用时功能受限;价格、平台支持范围等未在资料中说明,暂未提供。