sinapse-ai 5.0.8 → 6.0.1

package/docs/zh/sinapse-agent-flows/ux-design-expert-system.md

@@ -1,160 +0,0 @@
-# UX设计专家系统 SINAPSE
-
-> **版本:** 1.0.0
-> **创建于:** 2026-02-04
-> **所有者:** @ux-design-expert (Uma)
-> **状态:** 官方文档
-
----
-
-## 概览
-
-本文档描述了**UX设计专家(Uma)**代理的完整系统，包括所有涉及的文件、工作流、可用命令、与其他代理的集成和SINAPSE工作流。
-
-UX设计专家是一个混合型代理，结合了:
-- **Sally的UX原则** - 同理心、用户研究、以用户为中心的设计
-- **Brad Frost的系统原则** - 原子设计、设计令牌、指标和ROI
-
-### 目的
-
-该代理旨在:
-- 进行用户研究并创建角色
-- 创建线框和交互流
-- 审计现有代码库以识别UI冗余
-- 提取和整合设计令牌
-- 构建原子组件(原子、分子、有机体)
-- 确保无障碍访问(WCAG AA/AAA)
-- 计算设计系统的ROI和节省
-
----
-
-## 5阶段架构
-
-UX设计专家分5个阶段运营，每个阶段有特定命令:
-
-```mermaid
-flowchart TB
-    subgraph PHASE1["第1阶段: UX研究"]
-        R1["*research<br/>用户研究"]
-        R2["*wireframe<br/>创建线框"]
-        R3["*generate-ui-prompt<br/>v0/Lovable提示"]
-        R4["*create-front-end-spec<br/>前端规范"]
-    end
-
-    subgraph PHASE2["第2阶段: 设计系统审计"]
-        A1["*audit {path}<br/>扫描冗余"]
-        A2["*consolidate<br/>智能聚类"]
-        A3["*shock-report<br/>视觉HTML报告"]
-    end
-
-    subgraph PHASE3["第3阶段: 设计令牌"]
-        T1["*tokenize<br/>提取令牌"]
-        T2["*setup<br/>初始化DS"]
-        T3["*migrate<br/>迁移策略"]
-        T4["*upgrade-tailwind<br/>升级Tailwind v4"]
-        T5["*bootstrap-shadcn<br/>安装Shadcn/Radix"]
-    end
-
-    subgraph PHASE4["第4阶段: 组件构建"]
-        B1["*build {component}<br/>构建原子"]
-        B2["*compose {molecule}<br/>组成分子"]
-        B3["*extend {component}<br/>添加变体"]
-    end
-
-    subgraph PHASE5["第5阶段: 质量与文档"]
-        Q1["*document<br/>模式库"]
-        Q2["*a11y-check<br/>WCAG审计"]
-        Q3["*calculate-roi<br/>计算ROI"]
-    end
-
-    PHASE1 --> PHASE2
-    PHASE2 --> PHASE3
-    PHASE3 --> PHASE4
-    PHASE4 --> PHASE5
-
-    style PHASE1 fill:#e3f2fd
-    style PHASE2 fill:#fff3e0
-    style PHASE3 fill:#e8f5e9
-    style PHASE4 fill:#fce4ec
-    style PHASE5 fill:#f3e5f5
-```
-
----
-
-## 完整文件列表
-
-### 代理定义文件
-
-| 文件 | 目的 |
-|------|------|
-| `.sinapse-ai/development/agents/ux-design-expert.md` | 完整的代理定义(角色、命令、工作流) |
-| `.claude/commands/SINAPSE/agents/ux-design-expert.md` | Claude Code命令激活@ux-design-expert |
-
-### 按阶段的任务
-
-#### 第1阶段: UX研究与设计(4个任务)
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/ux-user-research.md` | `*research` | 进行用户研究、创建角色和旅程 |
-| `.sinapse-ai/development/tasks/ux-create-wireframe.md` | `*wireframe` | 创建低/中/高保真线框 |
-| `.sinapse-ai/development/tasks/generate-ai-frontend-prompt.md` | `*generate-ui-prompt` | 为v0.dev、Lovable.ai生成提示 |
-| `.sinapse-ai/development/tasks/create-doc.md` | `*create-front-end-spec` | 创建详细的前端规范 |
-
-#### 第2阶段: 设计系统审计(3个任务)
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/audit-codebase.md` | `*audit {path}` | 扫描代码库的UI冗余 |
-| `.sinapse-ai/development/tasks/consolidate-patterns.md` | `*consolidate` | 用HSL聚类减少冗余 |
-| `.sinapse-ai/development/tasks/generate-shock-report.md` | `*shock-report` | 生成视觉HTML报告 |
-
-#### 第3阶段: 设计令牌与设置(7个任务)
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/extract-tokens.md` | `*tokenize` | 提取设计令牌(YAML、JSON、CSS、DTCG) |
-| `.sinapse-ai/development/tasks/setup-design-system.md` | `*setup` | 初始化设计系统结构 |
-| `.sinapse-ai/development/tasks/generate-migration-strategy.md` | `*migrate` | 生成4阶段迁移策略 |
-| `.sinapse-ai/development/tasks/tailwind-upgrade.md` | `*upgrade-tailwind` | 升级到Tailwind CSS v4 |
-| `.sinapse-ai/development/tasks/audit-tailwind-config.md` | `*audit-tailwind-config` | 验证Tailwind配置 |
-| `.sinapse-ai/development/tasks/export-design-tokens-dtcg.md` | `*export-dtcg` | 导出W3C DTCG令牌 |
-| `.sinapse-ai/development/tasks/bootstrap-shadcn-library.md` | `*bootstrap-shadcn` | 安装Shadcn/Radix UI |
-
-#### 第4阶段: 原子组件构建(3个任务)
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/build-component.md` | `*build {component}` | 构建原子组件(React + TypeScript) |
-| `.sinapse-ai/development/tasks/compose-molecule.md` | `*compose {molecule}` | 从现有原子组成分子 |
-| `.sinapse-ai/development/tasks/extend-pattern.md` | `*extend {component}` | 向现有组件添加变体 |
-
-#### 第5阶段: 质量与文档(3个任务)
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/generate-documentation.md` | `*document` | 生成模式库文档 |
-| `.sinapse-ai/development/tasks/calculate-roi.md` | `*calculate-roi` | 计算ROI和成本节省 |
-| `.sinapse-ai/development/checklists/accessibility-wcag-checklist.md` | `*a11y-check` | WCAG无障碍审计 |
-
-#### 通用任务(2个任务)
-
-| 文件 | 命令 | 目的 |
-|------|------|------|
-| `.sinapse-ai/development/tasks/ux-ds-scan-artifact.md` | `*scan {path\|url}` | 分析HTML/React以提取模式 |
-| `.sinapse-ai/development/tasks/integrate-Squad.md` | `*integrate {squad}` | 与扩展小组连接 |
-
----
-
-## 总结
-
-| 方面 | 详情 |
-|------|------|
-| **总任务数** | 22个任务 |
-| **总命令数** | 19个命令+4个通用 |
-| **工作流阶段** | 5阶段 |
-| **协作代理** | 4个 |
-
----
-
-*-- Uma，以同理心设计*

package/docs/zh/sinapse-workflows/README.md

@@ -1,247 +0,0 @@
-# SINAPSE 工作流 - 工作流详细文档
-
-> 🌐 **简体中文** | [PT](../../sinapse-workflows/README.md) | [EN](../../en/sinapse-workflows/README.md) | [ES](../../es/sinapse-workflows/README.md)
-
----
-
-**版本:** 1.0.0
-**最后更新:** 2026-02-05
-**状态:** 官方文档
-
----
-
-## 概述
-
-本文件夹包含 SINAPSE 所有工作流的详细文档,包括:
-
-- **完整的 Mermaid 图表** (流程图、序列图、状态图)
-- **详细的步骤** 包括输入/输出
-- **参与的代理** 及其角色
-- **决策点** 和条件
-- **前置条件** 和配置
-- **故障排除** 和执行模式
-
----
-
-## 文档化的工作流
-
-### 按项目类型
-
-| 类型 | 工作流 | 描述 | 文档 |
-|------|--------|------|------|
-| **绿地项目** | 全栈 | 从零开始的全栈应用 | [greenfield-fullstack-workflow.md](./greenfield-fullstack-workflow.md) |
-| **绿地项目** | 服务 | 从零开始的后端/API | [greenfield-service-workflow.md](./greenfield-service-workflow.md) |
-| **绿地项目** | UI | 从零开始的前端 | [greenfield-ui-workflow.md](./greenfield-ui-workflow.md) |
-| **棕地项目** | 发现 | 现有项目分析 | [brownfield-discovery-workflow.md](./brownfield-discovery-workflow.md) |
-| **棕地项目** | 全栈 | 现有全栈演进 | [brownfield-fullstack-workflow.md](./brownfield-fullstack-workflow.md) |
-| **棕地项目** | 服务 | 现有后端演进 | [brownfield-service-workflow.md](./brownfield-service-workflow.md) |
-| **棕地项目** | UI | 现有前端演进 | [brownfield-ui-workflow.md](./brownfield-ui-workflow.md) |
-
-### 按流程
-
-| 流程 | 工作流 | 描述 | 文档 |
-|------|--------|------|------|
-| **开发** | 故事周期 | 完整的故事周期 | [story-development-cycle-workflow.md](./story-development-cycle-workflow.md) |
-| **质量** | 质量保证循环 | 质量周期 | [qa-loop-workflow.md](./qa-loop-workflow.md) |
-| **规范** | 规范管道 | 规范管道 | [spec-pipeline-workflow.md](./spec-pipeline-workflow.md) |
-| **设计** | 设计系统 | 设计系统构建 | [design-system-build-quality-workflow.md](./design-system-build-quality-workflow.md) |
-| **Git** | 自动工作树 | 自动工作树管理 | [auto-worktree-workflow.md](./auto-worktree-workflow.md) |
-
----
-
-## 每个文档的结构
-
-每个工作流文档遵循这个标准结构:
-
-```
-1. 概述
-   - 工作流的目标
-   - 支持的项目类型
-   - 何时使用/不使用
-
-2. Mermaid 图表
-   - 主流程图
-   - 状态图
-   - 序列图
-
-3. 详细步骤
-   - ID、代理、动作
-   - 输入和输出
-   - 成功标准
-   - 状态转换
-
-4. 参与的代理
-   - 每个代理的角色
-   - 相关命令
-
-5. 执行的任务
-   - 按阶段的任务映射
-   - 任务文件
-
-6. 前置条件
-   - 必需的配置
-   - 前置文档
-   - 集成工具
-
-7. 输入和输出
-   - 工作流输入
-   - 生成的输出
-
-8. 决策点
-   - 分支条件
-   - 阻塞标准
-
-9. 执行模式
-   - YOLO (自主)
-   - Interactive (平衡)
-   - Pre-Flight (规划)
-
-10. 故障排除
-    - 常见问题
-    - 日志和诊断
-
-11. 变更日志
-    - 版本历史
-```
-
----
-
-## 工作流地图
-
-```mermaid
-flowchart TB
-    subgraph GREENFIELD["绿地项目 (新项目)"]
-        GF["greenfield-fullstack"]
-        GS["greenfield-service"]
-        GU["greenfield-ui"]
-    end
-
-    subgraph BROWNFIELD["棕地项目 (现有项目)"]
-        BD["brownfield-discovery"]
-        BF["brownfield-fullstack"]
-        BS["brownfield-service"]
-        BU["brownfield-ui"]
-    end
-
-    subgraph PROCESS["流程"]
-        SDC["story-development-cycle"]
-        QAL["qa-loop"]
-        SP["spec-pipeline"]
-        DSB["design-system-build"]
-        AW["auto-worktree"]
-    end
-
-    BD --> BF
-    BD --> BS
-    BD --> BU
-
-    GF --> SDC
-    GS --> SDC
-    GU --> SDC
-    BF --> SDC
-    BS --> SDC
-    BU --> SDC
-
-    SDC --> QAL
-    SP --> SDC
-
-    style GREENFIELD fill:#c8e6c9
-    style BROWNFIELD fill:#fff9c4
-    style PROCESS fill:#e3f2fd
-```
-
----
-
-## 工作流选择指南
-
-### 新项目?
-
-```mermaid
-flowchart TD
-    A{项目类型?} --> B[全栈]
-    A --> C[仅后端/API]
-    A --> D[仅前端]
-
-    B --> E[greenfield-fullstack]
-    C --> F[greenfield-service]
-    D --> G[greenfield-ui]
-```
-
-### 现有项目?
-
-```mermaid
-flowchart TD
-    A{了解该项目?} --> |否| B[brownfield-discovery]
-    A --> |是| C{变更类型?}
-
-    B --> C
-
-    C --> D[全栈]
-    C --> E[仅后端]
-    C --> F[仅前端]
-
-    D --> G[brownfield-fullstack]
-    E --> H[brownfield-service]
-    F --> I[brownfield-ui]
-```
-
----
-
-## 工作流之间的流程
-
-| 从 | 到 | 条件 |
-|----|-----|------|
-| `brownfield-discovery` | `brownfield-*` | 完成分析后 |
-| `greenfield-*` | `story-development-cycle` | 每个故事 |
-| `brownfield-*` | `story-development-cycle` | 每个故事 |
-| `spec-pipeline` | `story-development-cycle` | 规范批准后 |
-| `story-development-cycle` | `qa-loop` | 质量保证阶段 |
-
----
-
-## 如何使用本文档
-
-### 启动项目
-
-1. 使用上面的 **选择指南** 选择工作流
-2. 阅读选定工作流的 **概述**
-3. 检查 **前置条件**
-4. 按顺序遵循 **步骤**
-
-### 理解流程
-
-1. 分析 **Mermaid 图表**
-2. 查看 **参与的代理** 及其角色
-3. 查阅 **决策点**
-
-### 调试问题
-
-1. 转至 **故障排除** 部分
-2. 检查 **日志和诊断**
-3. 查阅每个步骤的 **成功标准**
-
----
-
-## 与其他文档的关系
-
-| 文档 | 位置 | 用途 |
-|------|------|------|
-| 工作流指南 | [docs/guides/workflows-guide.md](../../guides/workflows-guide.md) | 一般指南 |
-| 代理流程 | [docs/sinapse-agent-flows/](../../sinapse-agent-flows/) | 代理详情 |
-| 代理参考 | [docs/agent-reference-guide.md](../../agent-reference-guide.md) | 快速参考 |
-
----
-
-## 贡献
-
-要添加或更新工作流文档:
-
-1. 遵循上面描述的标准结构
-2. 包括完整的 Mermaid 图表
-3. 记录所有输入/输出
-4. 保持变更日志最新
-5. 创建 EN 和 ES 翻译
-
----
-
-*SINAPSE 工作流文档 v1.0 - 开发工作流的详细文档*