该技能面向 CDS React 组件开发,规定组件研究、实现与测试流程:先调研相似参考组件与需求,必要时询问澄清问题;若同时要求 Web 与移动端,先在 Web 实现并配套单元测试与 stories,再处理移动端;未明确要求时不编写 Figma Code Connect 文件。
目录上,每个主组件独立文件夹,包含主组件文件、子组件、index.ts 导出、stories、tests 与 figma 等;组件按 buttons、controls、cards、overlays、layout、typography、icons、navigation 等类别归入分类文件夹。
约定包括:用 memo 记忆化组件,用 forwardRef 接受 ref,为无假值默认值的每个 prop 写带 @default 的 JSDoc,导出 *BaseProps 与 *Props 类型,支持样式覆盖,根元素支持 testID,使用设计令牌,以 padding 加 flex gap 代替 margin。
设计令牌来自 packages/common/src/core/theme.ts,含颜色、间距(8px 基准)、图标尺寸、头像尺寸、边框宽度/圆角、字体与阴影等;颜色为色相加步进体系,语义令牌映射光谱色并适配明暗模式。
常见模式有复合组件、Context 加 use*Context 钩子、受控/非受控双支持、泛型类型安全、复合组件排版属性透传、BaseProps 与 Props 分离及类型交叉组合规则。资料未提供具体安装命令、价格与限制信息。