aico-cli 2.0.28 → 2.0.30

package/templates/skills/swimlane-diagram/SKILL.md

@@ -1,242 +0,0 @@
----
-name: 泳道图生成器
-description: 专业生成系统架构和业务流程的泳道图。使用场景：系统架构设计、业务流程分析、跨系统交互流程、时序图、工作流可视化、多角色协作流程。支持用户旅程图、时序图、多角色协作流程。
-allowed-tools: Read, Write, Edit, Glob, Grep
----
-
-# 泳道图生成器
-
-## 概述
-
-泳道图生成器是一个专业的可视化工具，用于创建系统架构和业务流程的泳道图。基于支付宝碰一碰支付系统的示例，本技能支持Mermaid中的用户旅程图（User Journey）和时序图（Sequence Diagram）等真正的泳道图语法。
-
-## 核心功能
-
-### 1. 用户旅程图（User Journey Diagram）
-- **水平泳道**: 用户在不同阶段的体验流程
-- **垂直维度**: 时间轴或阶段划分
-- **多角色协作**: 展示用户与系统的交互过程
-- **情感曲线**: 支持用户情感状态的可视化
-
-### 2. 时序图（Sequence Diagram）
-- **垂直泳道**: 系统参与者的生命线
-- **消息传递**: 参与者间的交互消息
-- **时间顺序**: 严格的时间先后关系
-- **激活期**: 参与者的活跃时间段
-
-### 3. 输出格式
-- **Mermaid语法**: 标准Mermaid用户旅程图和时序图语法
-- **实时预览**: 支持在支持Mermaid的环境中实时预览
-- **HTML预览**: 生成交互式HTML预览页面
-- **Markdown导出**: 一键导出为Markdown文档
-- **兼容性**: 兼容GitHub、GitLab、Markdown编辑器等平台
-
-## 工作流程
-
-### 1. 需求分析
-- 分析用户描述的业务流程或系统架构
-- 识别关键参与者和系统角色
-- 确定主要流程和交互关系
-
-### 2. 泳道设计
-- 根据参与者数量设计水平泳道
-- 为每个泳道分配适当的标签和描述
-- 确定泳道间的交互关系
-
-### 3. 流程设计
-- 设计用户旅程的阶段和步骤
-- 添加交互消息和系统响应
-- 设计异常处理和错误流程
-
-### 4. 样式定制
-- 定义参与者样式和颜色方案
-- 设置消息类型和箭头样式
-- 添加注释和说明文字
-
-### 5. 生成输出
-- 生成标准的Mermaid语法
-- 提供完整的Markdown文档
-- 包含使用说明和预览方法
-
-## 使用指令
-
-### 用户旅程图语法结构
-```mermaid
-journey
-    title 用户支付流程
-    section 支付准备
-      用户打开应用: 5: 用户
-      选择商品: 4: 用户
-      进入支付页面: 3: 用户
-    section 支付过程
-      输入支付信息: 5: 用户
-      系统验证: 4: 系统
-      完成支付: 5: 用户
-    section 支付完成
-      显示支付结果: 3: 系统
-      更新订单状态: 4: 系统
-```
-
-### 时序图语法结构
-```mermaid
-sequenceDiagram
-    participant 用户
-    participant 前端系统
-    participant 支付网关
-    participant 银行系统
-
-    用户->>前端系统: 提交支付请求
-    前端系统->>支付网关: 转发支付信息
-    支付网关->>银行系统: 验证支付
-    银行系统-->>支付网关: 支付成功
-    支付网关-->>前端系统: 返回结果
-    前端系统-->>用户: 显示支付成功
-```
-
-### 节点类型和样式
-- **用户旅程图**: 使用阶段（section）和步骤描述
-- **时序图**: 使用参与者（participant）和消息传递
-- **情感曲线**: 在用户旅程图中显示用户满意度
-
-## 示例模板
-
-### 支付系统用户旅程图（基于支付宝示例）
-```mermaid
-journey
-    title 支付宝碰一碰支付用户旅程
-    section 设备准备阶段
-      用户打开支付宝应用: 5: 用户
-      POS终端设备初始化: 4: POS终端
-      系统检测设备状态: 3: 系统
-    section 触碰交互阶段
-      用户选择碰一碰功能: 5: 用户
-      用户触碰POS设备: 5: 用户
-      POS检测触碰信号: 4: POS终端
-      系统验证设备合法性: 4: 系统
-    section 支付处理阶段
-      生成支付请求: 5: POS终端
-      系统验证用户身份: 4: 系统
-      银行系统处理支付: 4: 银行系统
-      风险控制检查: 3: 风控系统
-    section 结果返回阶段
-      返回支付结果: 5: 系统
-      POS显示支付状态: 4: POS终端
-      用户确认支付结果: 5: 用户
-      更新订单状态: 3: 商户系统
-```
-
-### 支付系统时序图
-```mermaid
-sequenceDiagram
-    participant 用户
-    participant POS终端
-    participant 支付宝系统
-    participant 银行系统
-    participant 风控系统
-    participant 商户系统
-
-    用户->>POS终端: 打开支付宝并触碰设备
-    POS终端->>支付宝系统: 发送支付请求
-    支付宝系统->>银行系统: 验证支付信息
-    支付宝系统->>风控系统: 风险控制检查
-    银行系统-->>支付宝系统: 支付成功
-    风控系统-->>支付宝系统: 风险检查通过
-    支付宝系统-->>POS终端: 返回支付结果
-    POS终端-->>用户: 显示支付成功
-    支付宝系统->>商户系统: 更新订单状态
-    商户系统-->>支付宝系统: 订单更新完成
-```
-
-## 最佳实践
-
-### 1. 用户旅程图设计原则
-- **阶段划分**: 按照时间或逻辑将流程划分为清晰的阶段
-- **情感曲线**: 使用评分（1-5）表示用户在每个阶段的满意度
-- **用户视角**: 从用户角度描述体验过程
-- **简洁明了**: 每个阶段的步骤描述要简洁易懂
-
-### 2. 时序图设计原则
-- **参与者定义**: 明确定义每个参与者的角色和职责
-- **消息流向**: 使用正确的箭头表示消息方向（-> 同步，-->> 异步）
-- **时间顺序**: 严格按照时间顺序排列消息
-- **激活期**: 使用activate/deactivate表示参与者的活跃状态
-
-### 3. 样式设计原则
-- **一致性**: 相同类型的参与者使用相同样式
-- **可读性**: 确保图表在各种尺寸下都清晰可读
-- **专业性**: 使用专业的配色方案和布局
-
-## 工具集成
-
-### 支持的平台
-- **GitHub/GitLab**: 原生支持Mermaid语法
-- **VS Code**: 通过Mermaid插件预览
-- **Obsidian**: 内置Mermaid支持
-- **Typora**: 支持实时预览
-
-### 预览方法
-```bash
-# 在支持Mermaid的Markdown编辑器中预览
-# 或使用在线工具：https://mermaid.live/
-```
-
-## 故障排除
-
-### 常见问题
-1. **语法错误**: 检查journey和sequenceDiagram的正确语法
-2. **渲染问题**: 确保使用支持Mermaid的平台版本
-3. **布局混乱**: 调整阶段划分和参与者顺序
-
-### 调试技巧
-- 使用Mermaid Live Editor验证语法
-- 分步骤构建复杂的泳道图
-- 先设计主干流程，再添加细节和异常处理
-
-## 技术实现
-
-### 核心模块
-- **`swimlane-diagram.mjs`**: 主要实现类，提供图表生成功能
-- **`validators.mjs`**: 参数验证模块，确保输入数据的有效性
-- **`generators.mjs`**: 图表生成器模块，支持各种图表类型
-- **`swimlane-diagram.test.mjs`**: 完整的测试套件
-
-### API接口
-```javascript
-import SwimlaneDiagramGenerator from './swimlane-diagram.mjs';
-
-const generator = new SwimlaneDiagramGenerator();
-const mermaidCode = generator.generate({
-  type: 'journey', // 或 'sequence'
-  title: '图表标题',
-  data: [/* 数据结构 */]
-});
-```
-
-### 使用方式
-1. **编程方式**: 通过JavaScript API调用
-2. **命令行**: 使用npm scripts执行生成
-3. **预览模式**: 生成HTML预览页面
-4. **导出模式**: 导出为Markdown文档
-
-## 语法参考
-
-### 用户旅程图语法
-- `journey`: 声明用户旅程图
-- `title`: 设置图表标题
-- `section`: 定义阶段
-- `步骤描述: 评分: 参与者`: 定义具体步骤
-
-### 时序图语法
-- `sequenceDiagram`: 声明时序图
-- `participant 参与者`: 定义参与者
-- `A->>B: 消息`: 同步消息传递
-- `A-->>B: 消息`: 异步消息传递
-- `activate A`: 激活参与者
-- `deactivate A`: 停用参与者
-
-## 相关文件
-
-- **`README.md`**: 详细的使用说明和API文档
-- **`reference.md`**: 完整的语法参考手册
-- **`examples.md`**: 丰富的使用示例集
-- **`package.json`**: 项目配置和依赖管理

package/templates/skills/swimlane-diagram/examples.md

@@ -1,405 +0,0 @@
-# 泳道图示例集
-
-## 概述
-
-本示例集展示了真正的泳道图在不同业务场景下的应用，包括用户旅程图和时序图两种类型。每个示例都包含完整的Mermaid语法和详细说明，帮助用户快速理解和应用泳道图技术。
-
-## 示例1：电商支付系统时序图
-
-### 业务场景描述
-电商平台的完整支付流程，涉及用户、前端系统、支付网关、银行系统和商户系统的协作。
-
-### 时序图实现
-
-```mermaid
-sequenceDiagram
-    participant 用户
-    participant 前端系统
-    participant 支付网关
-    participant 银行系统
-    participant 商户系统
-    participant 风控系统
-
-    用户->>前端系统: 选择商品并下单
-    activate 前端系统
-    前端系统->>用户: 显示支付页面
-    用户->>前端系统: 提交支付信息
-    前端系统->>支付网关: 发送支付请求
-    deactivate 前端系统
-    activate 支付网关
-
-    支付网关->>风控系统: 风险检查
-    activate 风控系统
-    风控系统-->>支付网关: 风险检查通过
-    deactivate 风控系统
-
-    支付网关->>银行系统: 验证支付信息
-    activate 银行系统
-    银行系统-->>支付网关: 支付成功
-    deactivate 银行系统
-
-    支付网关->>商户系统: 更新订单状态
-    activate 商户系统
-    商户系统-->>支付网关: 订单更新完成
-    deactivate 商户系统
-
-    支付网关-->>前端系统: 返回支付结果
-    deactivate 支付网关
-    activate 前端系统
-    前端系统-->>用户: 显示支付成功
-    deactivate 前端系统
-```
-
-### 技术特点
-1. **异步处理**: 支付网关并行处理风控检查和银行验证
-2. **多层验证**: 风险检查、银行验证、商户通知
-3. **状态管理**: 使用activate/deactivate管理参与者状态
-4. **时序严格**: 严格按照时间顺序排列消息传递
-
-## 示例2：用户注册流程用户旅程图
-
-### 业务场景描述
-新用户注册账号的完整流程，包括信息验证、账户创建和确认流程。
-
-### 用户旅程图实现
-
-```mermaid
-journey
-    title 用户注册体验旅程
-    section 访问阶段
-      用户访问注册页面: 4: 用户
-      查看注册说明: 3: 用户
-      决定注册: 4: 用户
-    section 信息填写阶段
-      选择注册方式: 4: 用户
-      填写基本信息: 3: 用户
-      设置密码: 2: 用户
-      验证邮箱格式: 4: 系统
-    section 验证阶段
-      发送验证邮件: 4: 系统
-      检查邮箱收件: 3: 用户
-      点击验证链接: 5: 用户
-      验证链接有效: 4: 系统
-    section 完成阶段
-      账户激活成功: 5: 用户
-      自动登录系统: 4: 用户
-      查看欢迎页面: 5: 用户
-      完善个人资料: 3: 用户
-```
-
-### 用户体验分析
-1. **情感曲线**: 2-5分波动，密码设置体验较差，激活成功体验最佳
-2. **关键节点**: 邮箱验证是关键转折点
-3. **优化建议**: 简化密码设置流程，优化验证邮件体验
-
-## 示例3：数据同步系统时序图
-
-### 业务场景描述
-企业级数据同步系统，支持多数据源之间的数据同步和转换。
-
-### 时序图实现
-
-```mermaid
-sequenceDiagram
-    participant 调度服务
-    participant 抽取服务
-    participant 转换服务
-    participant 加载服务
-    participant 监控服务
-    participant 源数据库
-    participant 目标数据库
-
-    调度服务->>抽取服务: 启动同步任务
-    activate 抽取服务
-    抽取服务->>源数据库: 连接数据源
-    activate 源数据库
-    源数据库-->>抽取服务: 连接成功
-    deactivate 源数据库
-
-    抽取服务->>源数据库: 执行数据查询
-    activate 源数据库
-    源数据库-->>抽取服务: 返回数据集
-    deactivate 源数据库
-
-    抽取服务->>转换服务: 发送原始数据
-    deactivate 抽取服务
-    activate 转换服务
-
-    转换服务->>转换服务: 数据清洗
-    转换服务->>转换服务: 格式转换
-    转换服务->>转换服务: 数据验证
-
-    alt 验证通过
-        转换服务->>加载服务: 发送转换后数据
-        deactivate 转换服务
-        activate 加载服务
-
-        加载服务->>目标数据库: 连接目标库
-        activate 目标数据库
-        目标数据库-->>加载服务: 连接成功
-        deactivate 目标数据库
-
-        加载服务->>目标数据库: 批量插入数据
-        activate 目标数据库
-        目标数据库-->>加载服务: 插入成功
-        deactivate 目标数据库
-
-        加载服务->>监控服务: 同步完成通知
-        deactivate 加载服务
-        activate 监控服务
-        监控服务-->>调度服务: 任务完成
-        deactivate 监控服务
-    else 验证失败
-        转换服务->>监控服务: 数据验证失败
-        deactivate 转换服务
-        activate 监控服务
-        监控服务-->>调度服务: 任务失败
-        deactivate 监控服务
-    end
-```
-
-### 架构特点
-1. **模块化设计**: 抽取、转换、加载三个独立服务
-2. **异步通信**: 服务间通过消息传递实现异步处理
-3. **错误处理**: 完整的异常处理和通知机制
-4. **监控集成**: 全程监控和状态报告
-
-## 示例4：微服务调用链时序图
-
-### 业务场景描述
-微服务架构下的服务调用链，展示服务间的依赖关系和调用流程。
-
-### 时序图实现
-
-```mermaid
-sequenceDiagram
-    participant 客户端
-    participant API网关
-    participant 用户服务
-    participant 订单服务
-    participant 商品服务
-    participant 支付服务
-    participant 通知服务
-    participant 缓存系统
-    participant 数据库
-
-    客户端->>API网关: 发起下单请求
-    activate API网关
-
-    API网关->>缓存系统: 检查用户会话
-    activate 缓存系统
-    缓存系统-->>API网关: 会话有效
-    deactivate 缓存系统
-
-    API网关->>用户服务: 验证用户信息
-    activate 用户服务
-    用户服务->>数据库: 查询用户数据
-    activate 数据库
-    数据库-->>用户服务: 返回用户信息
-    deactivate 数据库
-    用户服务-->>API网关: 用户验证通过
-    deactivate 用户服务
-
-    API网关->>商品服务: 检查商品库存
-    activate 商品服务
-    商品服务->>数据库: 查询库存信息
-    activate 数据库
-    数据库-->>商品服务: 库存充足
-    deactivate 数据库
-    商品服务-->>API网关: 库存检查通过
-    deactivate 商品服务
-
-    par 并行处理
-        API网关->>订单服务: 创建订单
-        and
-        API网关->>支付服务: 处理支付
-    end
-
-    activate 订单服务
-    activate 支付服务
-
-    订单服务->>数据库: 保存订单数据
-    activate 数据库
-    数据库-->>订单服务: 订单创建成功
-    deactivate 数据库
-    订单服务-->>API网关: 订单创建完成
-    deactivate 订单服务
-
-    支付服务->>数据库: 记录支付信息
-    activate 数据库
-    数据库-->>支付服务: 支付记录成功
-    deactivate 数据库
-    支付服务-->>API网关: 支付处理完成
-    deactivate 支付服务
-
-    API网关->>通知服务: 发送通知
-    activate 通知服务
-    通知服务->>通知服务: 发送邮件通知
-    通知服务->>通知服务: 发送短信通知
-    通知服务-->>API网关: 通知发送完成
-    deactivate 通知服务
-
-    API网关-->>客户端: 返回下单结果
-    deactivate API网关
-```
-
-### 微服务特性
-1. **并行处理**: 订单创建和支付处理并行执行
-2. **服务解耦**: 通过API网关实现服务解耦
-3. **缓存优化**: 使用缓存系统提升性能
-4. **异步通知**: 通知服务异步处理邮件和短信
-
-## 示例5：企业级部署流程用户旅程图
-
-### 业务场景描述
-企业级软件系统的完整部署流程，涉及多个角色和阶段的协作。
-
-### 用户旅程图实现
-
-```mermaid
-journey
-    title 企业系统部署流程
-    section 需求分析阶段
-      业务需求收集: 5: 产品经理
-      技术可行性评估: 4: 架构师
-      资源需求评估: 3: 运维工程师
-      部署方案设计: 4: 架构师
-    section 环境准备阶段
-      开发环境搭建: 3: 开发工程师
-      测试环境配置: 4: 测试工程师
-      预生产环境准备: 4: 运维工程师
-      生产环境规划: 3: 运维工程师
-    section 开发测试阶段
-      功能开发实现: 4: 开发工程师
-      单元测试执行: 4: 测试工程师
-      集成测试验证: 5: 测试工程师
-      性能测试评估: 3: 测试工程师
-    section 部署上线阶段
-      代码审查通过: 4: 架构师
-      部署脚本执行: 4: 运维工程师
-      系统监控配置: 5: 运维工程师
-      上线验证测试: 5: 测试工程师
-    section 运维监控阶段
-      系统性能监控: 4: 运维工程师
-      日志分析处理: 3: 开发工程师
-      问题快速响应: 4: 运维团队
-      用户培训支持: 5: 产品经理
-```
-
-### 流程特点
-1. **多角色协作**: 产品经理、架构师、开发、测试、运维等多个角色参与
-2. **阶段清晰**: 从需求分析到运维监控的完整流程
-3. **质量保证**: 多层测试和验证机制
-4. **持续优化**: 部署后的监控和改进
-
-## 示例6：移动应用用户体验时序图
-
-### 业务场景描述
-移动应用的完整用户交互流程，包括客户端、服务器、第三方服务的交互。
-
-### 时序图实现
-
-```mermaid
-sequenceDiagram
-    participant 用户
-    participant 移动客户端
-    participant API网关
-    participant 认证服务
-    participant 业务服务
-    participant 第三方服务
-    participant 推送服务
-    participant 数据库
-
-    用户->>移动客户端: 启动应用
-    activate 移动客户端
-    移动客户端->>API网关: 请求初始化数据
-    activate API网关
-
-    API网关->>认证服务: 验证用户令牌
-    activate 认证服务
-    认证服务->>数据库: 查询令牌信息
-    activate 数据库
-    数据库-->>认证服务: 令牌有效
-    deactivate 数据库
-    认证服务-->>API网关: 认证通过
-    deactivate 认证服务
-
-    API网关->>业务服务: 获取用户数据
-    activate 业务服务
-    业务服务->>数据库: 查询用户信息
-    activate 数据库
-    数据库-->>业务服务: 返回用户数据
-    deactivate 数据库
-    业务服务-->>API网关: 返回业务数据
-    deactivate 业务服务
-
-    API网关-->>移动客户端: 返回初始化数据
-    deactivate API网关
-    移动客户端-->>用户: 显示主界面
-
-    用户->>移动客户端: 执行业务操作
-    移动客户端->>API网关: 提交操作请求
-    activate API网关
-
-    API网关->>第三方服务: 调用外部接口
-    activate 第三方服务
-    第三方服务-->>API网关: 返回处理结果
-    deactivate 第三方服务
-
-    API网关->>业务服务: 处理业务逻辑
-    activate 业务服务
-    业务服务->>数据库: 更新业务数据
-    activate 数据库
-    数据库-->>业务服务: 更新成功
-    deactivate 数据库
-    业务服务-->>API网关: 处理完成
-    deactivate 业务服务
-
-    API网关->>推送服务: 发送推送通知
-    activate 推送服务
-    推送服务->>推送服务: 构建推送消息
-    推送服务-->>移动客户端: 推送通知
-    deactivate 推送服务
-
-    API网关-->>移动客户端: 返回操作结果
-    deactivate API网关
-    移动客户端-->>用户: 显示操作结果
-```
-
-### 技术亮点
-1. **多层认证**: 令牌验证和用户状态检查
-2. **第三方集成**: 与外部服务的无缝集成
-3. **实时推送**: 即时通知用户操作结果
-4. **状态管理**: 完善的激活状态管理
-
-## 使用指南
-
-### 如何选择合适的泳道图类型
-
-#### 用户旅程图适用于：
-- **用户体验分析**: 分析用户在各个环节的体验感受
-- **服务设计**: 优化服务流程和触点设计
-- **多角色协作**: 展示不同角色在流程中的参与情况
-- **情感曲线分析**: 通过评分系统分析用户情感变化
-
-#### 时序图适用于：
-- **系统架构设计**: 展示系统间的交互关系
-- **API设计**: 定义接口调用时序和参数
-- **问题排查**: 分析系统调用链中的问题点
-- **性能优化**: 识别系统瓶颈和优化机会
-
-### 定制建议
-
-1. **参与者命名**: 使用简洁明了的参与者名称
-2. **消息描述**: 消息描述要具体且易于理解
-3. **阶段划分**: 用户旅程图的阶段要符合业务逻辑
-4. **评分系统**: 评分要真实反映用户体验
-
-### 最佳实践
-
-1. **保持简洁**: 避免过多的参与者和复杂的交互
-2. **逻辑清晰**: 确保时序逻辑和业务逻辑一致
-3. **完整覆盖**: 覆盖主要的业务流程和异常情况
-4. **持续迭代**: 根据反馈持续优化泳道图设计
-
-通过这些示例，您可以快速掌握真正的泳道图设计技巧，并将其应用到实际的系统设计和业务流程分析中。每个示例都经过精心设计，确保语法正确性和实用性。