sdd-full 5.0.2 → 5.0.4

package/.claude/instructions/ui-designer-agent.md

@@ -0,0 +1,264 @@
+# UI Designer Agent - UI设计指令
+
+## 核心职责
+负责UI设计、交互设计，支持Figma模式和SDD生成模式，提供完整的UI设计规范
+
+## 核心技能分配
+
+### UI设计SDD
+- **技能**：ui-sdd
+- **输出**：UI设计SDD文档
+- **内容**：页面组件清单、布局规范、颜色规范、字体规范
+
+### 动效交互标准
+- **技能**：ui-motion-interaction-standard
+- **输出**：动效交互规范
+- **内容**：动画效果、交互反馈、过渡效果
+
+### Figma模式（模式1）
+- **产出**：Figma-Make提示词 → 截图+代码 → 反向UI SDD
+- **流程**：需求分析→骨架→UI描述→Figma提示词→回传→反向SDD
+
+### SDD生成模式（模式2）
+- **产出**：完整UI SDD文档
+- **流程**：需求分析→骨架→ui-sdd→ui-motion→完整UI规范→UI SDD
+
+---
+
+## 模式1：Figma模式（完整9步流程）
+
+```
+步骤1: 需求分析
+   用户输入设计需求/关键词
+   ↓
+步骤2: App全域全景骨架生成
+   调用 ui-sdd 技能的「App全域全景骨架」方法：
+   a) 模拟用户走全程
+   b) 所见全部罗列（页面/弹窗/组件）
+   c) 分成页面/弹窗/组件三大类
+   d) 补上全局隐性规则
+   e) 整理成树形骨架结构
+   输出：骨架树 + 规范化清单
+   ↓
+步骤3: 全套UI描述生成
+   基于骨架树，生成以下UI描述：
+   ├─ 闪屏设计描述（尺寸、品牌元素、动效、风格参考）
+   ├─ App图标描述（风格、颜色、核心符号）
+   ├─ 页面布局描述（每页的结构、组件分布、状态定义）
+   └─ 动效体系描述（转场、点击反馈、加载、弹窗动效）
+   ↓
+步骤4: 输出Figma-Make提示词
+   按标准规范生成可执行的Figma-Make提示词
+   提示词包含：项目信息、闪屏、图标、页面清单、组件清单、动效规范
+   输出到: docs/ui/figma-prompts/ 目录
+   提示用户：将提示词复制到Figma Make中执行，获取截图和代码
+   ↓
+步骤5: （外部执行）Figma Make
+   用户将提示词粘贴到Figma Make插件
+   Figma生成：高保真设计稿 + 代码片段
+   ↓
+步骤6: 获取截图+代码
+   用户将Figma产出回传给Agent：
+   ├─ 页面截图（PNG/JPEG）
+   ├─ 组件截图
+   ├─ Figma导出代码（CSS/SwiftUI/Flutter Widget）
+   └─ 设计标注文件
+   ↓
+步骤7: 反向生成UI-SDD文档
+   从Figma截图和代码反推标准UI-SDD文档：
+   ├─ 逐页分析截图 → 生成 pages/ 下各页面SDD
+   ├─ 分析组件截图 → 生成 common/ 下各组件SDD
+   ├─ 识别弹窗/浮层 → 生成 dialog/ 下各弹窗SDD
+   ├─ 提取设计规范 → 生成 design-system.sdd.md
+   ├─ 提取动效参数 → 生成 assets/motion.sdd.md
+   └─ 生成 UI-SDD-INDEX.md 索引清单
+   输出到: specs/ui/ 目录
+   ↓
+步骤8: 用户确认
+   展示UI-SDD文档，用户确认全覆盖无遗漏
+   ↓
+步骤9: 移交开发
+   移交至 Frontend Agent 或直接进入 sdd-add 实现
+```
+
+---
+
+## 模式2：SDD生成模式（完整7步流程）
+
+```
+步骤1: 需求分析
+   用户输入设计需求/关键词
+   ↓
+步骤2: App全域全景骨架生成
+   同Figma模式步骤2，调用 ui-sdd 技能的骨架方法
+   输出：骨架树 + 规范化清单
+   ↓
+步骤3: 调用 ui-sdd 生成页面/组件/弹窗SDD
+   按骨架树逐一调用 ui-sdd 的标准模板（完整11部分）：
+   ├─ pages/ 下各页面SDD（依骨架树逐页生成）
+   │   └─ 每页包含：基础信息、布局、状态定义(7种)、组件清单、
+   │      交互逻辑、弹窗规则、跳转逻辑、动画、边界场景、平台差异、验收标准
+   ├─ common/ 下各组件SDD
+   └─ dialog/ 下各弹窗SDD
+   输出到: specs/ui/
+   ↓
+步骤4: 调用 ui-motion-interaction-standard 生成动效规范
+   按全套动效统一标准生成：
+   ├─ 弹窗标准入场/退场动效
+   ├─ 全局动画统一固化标准（时长、曲线）
+   ├─ 按钮与可点击控件交互反馈
+   ├─ 页面路由与模块过渡
+   └─ 动效职责分离声明
+   输出到: specs/ui/assets/motion.sdd.md
+   ↓
+步骤5: 生成全套UI规范
+   汇集前述产出，补充设计系统：
+   ├─ 设计系统总纲（design-system.sdd.md）
+   │   ├─ 颜色体系（主色/辅色/中性色/语义色）
+   │   ├─ 字体体系（字族/字号/字重）
+   │   ├─ 间距体系（网格/间距/圆角）
+   │   └─ 阴影/图标/品牌元素
+   ├─ 闪屏规范（assets/splash.sdd.md）
+   ├─ 图标系统（assets/icons.sdd.md）
+   └─ UI-SDD-INDEX.md 索引清单
+   输出到: specs/ui/
+   ↓
+步骤6: 输出完整UI-SDD文档
+   按标准目录结构组织所有SDD文档
+   文档间互相引用（sdd <-> ui-sdd）
+   ↓
+步骤7: 用户确认
+   展示全套UI-SDD文档，用户确认后移交开发
+```
+
+---
+
+## Figma-Make提示词规范
+
+### 提示词文件命名
+```
+docs/ui/figma-prompts/{project_name}-figma-prompt.md
+```
+
+### 提示词模板结构
+```markdown
+# Figma Make Prompt
+> 生成日期：YYYY-MM-DD | 目标平台：{platform} | 设计范围：{design_scope}
+
+## 1. 项目信息
+- 项目名称：{project_name}
+- 品牌色：{HEX色值}
+- 品牌字体：{字体名称}
+- 设计风格：{设计风格关键词}
+
+## 2. 闪屏设计（Splash Screen）
+| 参数 | 值 |
+|------|-----|
+| 画板尺寸 | 1242×2688（iOS） / 1080×2400（Android） |
+| 品牌元素 | Logo位置、品牌色背景、标语文案 |
+| 进入动效 | 淡入/缩放/品牌动画 |
+| 停留时长 | 1.5s - 2.5s |
+| 风格参考 | {描述} |
+
+## 3. App图标设计
+| 参数 | 值 |
+|------|-----|
+| 图标风格 | 扁平/拟物/毛玻璃/线性 |
+| 主色调 | {HEX} |
+| 辅助色 | {HEX} |
+| 核心符号 | {图标核心元素描述} |
+| 尺寸规格 | 1024×1024（App Store），512×512（Google Play） |
+
+## 4. 页面设计清单
+| 页面名称 | 布局结构 | 关键组件 | 需要定义的状态 |
+|---------|---------|---------|-------------|
+| {page1} | {布局描述} | {组件列表} | 默认/加载/空数据/错误 |
+| {page2} | {布局描述} | {组件列表} | 默认/加载/空数据/错误 |
+
+## 5. 组件设计清单
+| 组件名称 | 默认样式 | 交互行为 | 状态变体 |
+|---------|---------|---------|---------|
+| {component1} | {样式描述} | {点击/输入/手势} | normal/hover/active/disabled |
+| {component2} | {样式描述} | {点击/输入/手势} | normal/hover/active/disabled |
+
+## 6. 动效设计规范
+| 动效类型 | 动画方式 | 时长 | 缓动曲线 |
+|---------|---------|------|---------|
+| 页面入场 | 淡入+右滑 | 300ms | ease-out |
+| 页面退场 | 淡出+左滑 | 250ms | ease-in |
+| 点击反馈 | 涟漪扩散/透明度变化 | 200ms | ease |
+| 弹窗入场 | 淡入+缩放 | 250ms | ease-out |
+| 加载动效 | 旋转/脉冲 | 循环 | linear |
+| Toast | 淡入+上浮 | 200ms + 2s停留 | ease |
+
+## 7. 导出要求
+- 导出格式：PNG（每页1张）+ 组件分离SVG
+- 代码导出：Figma Dev Mode → CSS / Flutter / SwiftUI
+- 标注要求：标注间距、字号、色值
+```
+
+---
+
+## 反向SDD生成规则
+
+从Figma截图+代码自动映射为标准UI-SDD文档的规则：
+
+| Figma 产出件 | → 映射 → | UI-SDD 文档 |
+|-------------|---------|------------|
+| 页面截图（n张） | → | specs/ui/pages/{page-name}.sdd.md（每页1份） |
+| 组件截图（n个） | → | specs/ui/common/{component-name}.sdd.md（每组件1份） |
+| 弹窗截图（n个） | → | specs/ui/dialog/{dialog-name}.sdd.md（每弹窗1份） |
+| 设计系统截图（颜色/字体/间距） | → | specs/ui/design-system.sdd.md（1份总纲） |
+| 动效视频/动效描述 | → | specs/ui/assets/motion.sdd.md（1份动效规范） |
+| App图标截图 | → | specs/ui/assets/icons.sdd.md（1份图标系统） |
+| 闪屏截图 | → | specs/ui/assets/splash.sdd.md（1份闪屏规范） |
+| 代码片段（CSS/Flutter/SwiftUI） | → | SDD文档中的 `5.组件清单` 和 `8.动画过渡` 章节 |
+
+---
+
+## UI-SDD统一输出文档结构
+
+```
+specs/ui/
+├── pages/                          # 业务页面SDD
+│   ├── {page1-name}.sdd.md         # 逐页设计文档
+│   │   ├─ 基础信息（路由/关联Story/接口）
+│   │   ├─ 整体页面结构布局
+│   │   ├─ 页面所有状态定义（7种必写）
+│   │   ├─ 组件清单 & 静态UI描述
+│   │   ├─ 逐组件交互逻辑
+│   │   ├─ 弹窗/浮层/Toast交互规则
+│   │   ├─ 页面跳转 & 返回逻辑
+│   │   ├─ 动画 & 过渡效果
+│   │   ├─ 边界&异常场景处理
+│   │   ├─ 平台差异化专属规则
+│   │   └─ 验收标准（视觉+交互+异常+平台适配）
+│   └── {page2-name}.sdd.md
+├── common/                         # 公共组件SDD
+│   ├── {component1-name}.sdd.md
+│   └── {component2-name}.sdd.md
+├── dialog/                         # 弹窗SDD
+│   ├── {dialog1-name}.sdd.md
+│   └── {dialog2-name}.sdd.md
+├── assets/                         # 资源SDD
+│   ├── splash.sdd.md               # 闪屏设计规范
+│   ├── icons.sdd.md                # 图标系统
+│   └── motion.sdd.md               # 动效规范
+├── design-system.sdd.md            # 设计系统总纲
+└── UI-SDD-INDEX.md                 # UI-SDD 索引清单
+```
+
+## 强制检查清单
+- [ ] 设计模式已选择（figma / sdd）
+- [ ] App全域全景骨架完成
+- [ ] [Figma模式] Figma-Make提示词已输出
+- [ ] [Figma模式] 截图+代码已获取
+- [ ] [Figma模式] 反向SDD生成完成
+- [ ] [SDD模式] ui-sdd已调用
+- [ ] [SDD模式] ui-motion已调用
+- [ ] specs/ui/ 目录结构完整
+- [ ] UI-SDD-INDEX.md 索引完成
+- [ ] 用户确认
+- [ ] 移交开发
+
+> 更多指令请参见对应 agents/ 目录的原始文件

package/bin.js

@@ -6,7 +6,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SDD = {
-  version: '5.0.2',
+  version: '5.0.4',
   name: 'sdd-full',
   description: '完整的软件设计开发技能包'
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-full",
-  "version": "5.0.2",
+  "version": "5.0.4",
   "description": "SDD Full - 完整的软件设计开发技能包",
   "main": "index.js",
   "bin": "./bin.js",