用途:把 PSD 图层树按第一级分组拆分为多个独立组件文件,支持 React(JSX + CSS Modules)与 Vue(SFC),便于组件化开发和团队协作。
主要能力:读取图层树 JSON,遍历第一级 kind 为 group 的节点;将分组名转换为 PascalCase 组件名;生成主入口 App.jsx / App.vue 整合子组件;复制切片图片到 images/ 目录。React 侧使用 CSS Modules 隔离样式并支持 className、style、onClick props,采用 BEM 类名;Vue 侧输出单文件组件、Scoped CSS 并支持 props。
使用方式:需先用前置技能导出切片与图层结构。
1. 导出图层切片
py -3 .claude/skills/psd-slicer/scripts/export_slices.py
design.psd -o sliced-images/
2. 生成图层结构 JSON
py -3 .claude/skills/psd-layer-reader/scripts/psd_layers.py
design.psd -o layer-tree.json
再运行拆分脚本,必需参数为 --json、--images、--out、--framework(react 或 vue),可选 --component-name(默认 PsdApp)。输出到 <out>/react-split/ 或 <out>/vue-split/。
适用场景:PSD 第一级分组代表不同功能模块、需要组件化开发与独立维护、团队协作。
限制:不适用于无明确分组的 PSD;像素级单页预览应使用 psd-json-preview,响应式 flexbox 布局应使用 psd-semantic-layout。常见问题包括未找到有效第一级分组、生成器模块缺失、图片未复制(可检查切片映射与 JSON name 字段是否一致)。