sdd-full 5.0.1 → 5.0.3

package/.claude/rules/user_rules.md

@@ -0,0 +1,150 @@
+# 个人规则 - SDD全流程开发技能体系
+
+## 一、技能地图
+
+### 需求分析类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| brainstorming | 项目初期、需求不确定时 |
+| market-research | 了解竞品、市场情况 |
+| competitive-brief | 分析竞品差异 |
+| prd-write | 新项目立项、需求定义 |
+| requirement-completion-officer | 需求不明确时 |
+| sdd | 大型需求结构化拆分 |
+| sdd-full | 需要完整SDD流程 |
+
+### 设计规划类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| ui-sdd | UI设计阶段 |
+| sdd-code | 功能实现设计 |
+| sdd-test | 测试设计阶段 |
+| sdd-deploy | 部署设计阶段 |
+| sdd-ops | 运维设计阶段 |
+| writing-plans | 需要制定详细计划 |
+
+### 开发执行类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| sdd-add | 快速迭代、小型功能 |
+| test-driven-development | TDD开发模式 |
+| systematic-debugging | 调试Bug时 |
+| verification-before-completion | 提交/发布前验证 |
+
+### 质量保障类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| quality-gate | 发布前质量把关 |
+| security-audit | 安全漏洞检查 |
+
+### 发布运维类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| finishing-a-development-branch | 合并开发分支前 |
+| release-flow | 完整发布生命周期 |
+
+### 知识沉淀类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| claudeception | 沉淀可复用知识 |
+| mempalace-auto-saver | 自动保存会话记忆 |
+
+### 专项工具类
+| 技能名称 | 适用场景 |
+|---------|---------|
+| using-superpowers | 使用Superpowers全流程 |
+| requesting-code-review | 需要代码审查 |
+| receiving-code-review | 处理代码审查反馈 |
+
+---
+
+## 二、调用决策树
+
+### 问题1：我现在要做什么？
+
+#### 选项A：我有一个新项目，从零开始
+→ 子问题：需要先创意/调研吗？
+→ → 是：**brainstorming** / **market-research** / **competitive-brief**
+→ → 否：跳过
+→ 然后：**prd-write**（写PRD，可选）→ **sdd**（拆需求）或 **sdd-full**（完整SDD流程）
+→ 然后到「选项E：我要设计/开发了」
+
+#### 选项B：我要做新功能/大需求
+→ **sdd**（基础SDD拆分）或 **sdd-full**（完整SDD流程）→ 到「选项E：我要设计/开发了」
+
+#### 选项C：我要做小功能迭代
+→ 子问题：需求是否明确？
+→ → 否：**requirement-completion-officer**（需求补全）
+→ → 是：跳过
+→ **sdd-add**（快速落地）
+→ 如果需要UI：补充调用 **ui-sdd**
+→ 如果需要制定计划：**writing-plans**
+
+#### 选项D：我要发布代码
+→ 子问题：质量检查做了吗？
+→ → 否：**quality-gate**（先做质量检查）
+→ → 是：继续
+→ 子问题：是否完成开发分支？
+→ → 是：**finishing-a-development-branch**
+→ → 否：跳过
+→ **sdd-deploy**（部署设计，可选）→ **release-flow**（发布管理）
+
+#### 选项E：我要设计/开发了
+→ 子问题1：需要UI设计吗？
+→ → 是：**ui-sdd**
+→ → 否：跳过
+→ 子问题2：需要拆实现SDD吗？
+→ → 是：**sdd-code**（含代码规范、技术债务、重构计划）
+→ → 否：跳过
+→ 子问题3：需要设计测试吗？
+→ → 是：**sdd-test**
+→ → 否：跳过
+→ 子问题4：需要设计部署吗？
+→ → 是：**sdd-deploy**
+→ → 否：跳过
+→ 子问题5：需要设计运维吗？
+→ → 是：**sdd-ops**
+→ → 否：跳过
+→ 然后开始开发（sdd-add/test-driven-development/等）
+
+#### 选项F：我要处理Bug
+→ 子问题：Bug属于什么类型？
+→ → **简单Bug（已知原因）**：直接修复 → verification-before-completion → quality-gate → claudeception
+→ → **复杂Bug（原因不明）**：bug-reproduction-confirm → systematic-debugging → verification-before-completion → quality-gate → claudeception
+→ → **性能问题**：performance-optimize → verification-before-completion → quality-gate → claudeception
+→ → **安全漏洞**：security-audit → bug-reproduction-confirm → systematic-debugging → verification-before-completion → quality-gate → security-audit → claudeception
+→ → **回归Bug**：bug-reproduction-confirm → systematic-debugging → Test-SDD补充 → 修复 → verification-before-completion → quality-gate → claudeception
+→ → **Flutter iOS真机调试**：env-check → bug-reproduction-confirm → flutter-errors → 定位修复 → 真机验证 → verification-before-completion → quality-gate → claudeception
+
+#### 选项G：我要做测试
+→ **sdd-test**（设计测试）→ **test-driven-development**（TDD开发）
+
+#### 选项H：我要做竞品分析
+→ **competitive-brief** / **market-research**
+
+#### 选项I：我要安全检查
+→ **security-audit**
+
+#### 选项J：我要保存/提取经验
+→ **claudeception** / **mempalace-auto-saver**
+
+---
+
+## 六、个人偏好设置
+
+### 默认项目名称
+- 默认项目：个人备忘录APP
+
+### 自动保存设置
+- [x] 自动保存记忆（mempalace-auto-saver）
+- [x] 定期提取经验（claudeception）
+
+### 质量检查设置
+- [x] 发布前自动触发 quality-gate
+- [x] 提交前自动触发 verification-before-completion
+
+---
+
+**版本**: v1.0
+**更新时间**: 2026-05-06
+**适用项目**: sdd-full-npm

package/{skills → .claude/skills}/README.md

@@ -2,18 +2,18 @@
 
 # SDD Full 技能包
 
-**版本**: 5.0.1  
-**发布日期**: 2026-05-09  
-**更新时间**: 2026-05-09 10:35:00  
+**版本**: 5.1.0  
+**发布日期**: 2026-05-12  
+**更新时间**: 2026-05-12 10:35:00  
 
 ---
 
 ## 技能包概览
 
-- **技能数量**: 55+ 个技能
-- **分层结构**: 10 个层级
-- **SDD 模板**: 25 种标准化/专项模板
-- **规则文件**: 2 个项目级规则
+- **技能数量**: 46 个技能
+- **分层结构**: 7 个层级
+- **SDD 模板**: 21 种标准化/专项模板
+- **规则文件**: 2 个项目级规则（已移至 .claude/rules/）
 
 ---
 
@@ -21,26 +21,31 @@
 
 ```
 skills/
-├── requirement-analysis/     # 需求分析层（7个技能）
-├── design-planning/          # 设计规划层（15个技能）
-├── development-execution/    # 开发执行层（7个技能）
-├── flutter/                  # Flutter专项技能层（10个技能）
-├── quality-assurance/        # 质量保障层（4个技能）
-├── release-ops/              # 发布运维层（2个技能）
-├── knowledge-precipitation/  # 知识沉淀层（2个技能）
-├── special-tools/            # 专项工具层（5个技能）
-├── writing-skills/           # 技能编写工具层（1个技能）
-├── call-adaptation/          # 调用机制适配（1个）
-├── templates/                # SDD模板库（25个模板）
-├── rules/                    # 规则文件（2个）
-├── README.md                 # 本文件（技能目录索引+版本信息）
+├── sdd-common/             # 通用技能索引（1个）
+├── requirement-analysis/   # 需求分析层（6个技能）
+├── design-planning/        # 设计规划层（7个技能）
+├── development-execution/  # 开发执行层（7个技能）
+├── flutter/                # Flutter专项技能层（13个技能）
+├── quality-assurance/      # 质量保障层（6个技能）
+├── release-ops/            # 发布运维层（2个技能）
+├── knowledge-precipitation/# 知识沉淀层（2个技能）
+├── special-tools/          # 专项工具层（4个技能）
+├── templates/              # SDD模板库（21个模板）
+├── README.md               # 本文件（技能目录索引+版本信息）
+
+../agents/                 # 多Agent架构（19个）
+../rules/                  # 规则文件（2个）
+../standards/              # 规范文件（5个）
 ```
 
 ---
 
 ## 详细技能列表
 
-### 1. 需求分析层（7个）
+### 1. 通用索引（1个）
+- sdd-common - SDD全流程通用技能索引
+
+### 2. 需求分析层（6个）
 - brainstorming - 创意头脑风暴
 - competitive-brief - 竞品简报
 - market-research - 市场调研
@@ -49,24 +54,17 @@ skills/
 - sdd - 基础SDD拆分
 - sdd-full - 完整SDD流程
 
-### 2. 设计规划层（15个）
+### 3. 设计规划层（7个）
 - ai-coding-rules - AI编码规则
 - design-to-code - 设计转代码
-- enterprise-spec - 企业级工程规范
-- flutter-av - Flutter音视频
-- flutter-map - Flutter地图导航
-- function-sdd - 功能SDD
-- global-overlay-stack-standard - 全局浮层堆叠规范
 - sdd-code - 代码实现SDD
 - sdd-deploy - 部署SDD
-- sdd-ops - 运维SDD
 - sdd-test - 测试SDD
 - ui-motion-interaction-standard - UI动效交互规范
 - ui-sdd - UI交互SDD
-- ui-sdd-specialized - 专用UI-SDD
 - writing-plans - 编写计划
 
-### 3. 开发执行层（7个）
+### 4. 开发执行层（7个）
 - bug-reproduction-confirm - Bug复现确认
 - flutter-errors - Flutter异常排查
 - performance-optimize - 性能优化
@@ -75,7 +73,7 @@ skills/
 - test-driven-development - TDD开发
 - verification-before-completion - 完成前验证
 
-### 4. Flutter专项技能层（10个）
+### 5. Flutter专项技能层（13个）
 - flutter-add-integration-test - 集成测试
 - flutter-add-widget-preview - 组件预览
 - flutter-add-widget-test - 组件测试
@@ -86,34 +84,29 @@ skills/
 - flutter-setup-declarative-routing - 声明式路由
 - flutter-setup-localization - 本地化
 - flutter-use-http-package - HTTP网络请求
+- flutter-test - Flutter测试策略
+- ios-full-auto-debug - iOS真机全自动化调试
 
-### 5. 质量保障层（4个）
+### 6. 质量保障层（6个）
 - bdd-acceptance - BDD验收标准
-- flutter-test - Flutter测试策略
 - quality-gate - 质量门禁
 - security-audit - 安全审计
+- requesting-code-review - 请求代码审查
+- receiving-code-review - 接收代码审查
 
-### 6. 发布运维层（2个）
+### 7. 发布运维层（2个）
 - finishing-a-development-branch - 完成开发分支
 - release-flow - 发布流程
 
-### 7. 知识沉淀层（2个）
+### 8. 知识沉淀层（2个）
 - claudeception - 持续学习
 - mempalace-auto-saver - 自动保存记忆
 
-### 8. 专项工具层（5个）
+### 9. 专项工具层（4个）
 - env-check - 环境预检
-- ios-full-auto-debug - iOS真机全自动化调试
-- receiving-code-review - 接收代码审查
-- requesting-code-review - 请求代码审查
-- using-superpowers - Superpowers全流程
-
-### 9. 技能编写工具层（1个）
+- design-contract-expert - 设计契约专家
 - writing-skills - 技能编写工具
 
-### 10. 调用机制适配（1个）
-- call-adaptation - 双调用机制适配
-
 ---
 
 ## SDD 模板列表
@@ -131,7 +124,7 @@ skills/
 | Env-SDD | Env | 环境配置 |
 | Test-SDD | Test | 测试设计 |
 
-### 专项模板（16个）
+### 专项模板（12个）
 | 模板名称 | 适用场景 |
 |---------|---------|
 | UI-SDD专用模板 | UI设计阶段 |
@@ -175,7 +168,17 @@ npx sdd-full --help
 
 ## 更新历史
 
-### v4.9.0 (2026-05-09)
+### v5.1.0 (2026-05-12)
+- 完成多Agent架构重构（19个Agent）
+- 补充8个Agent的Slots定义
+- Agent新增Standards规范引用
+- Rules目录移至 .claude/rules/
+- Standards目录移至 .claude/standards/
+- 清理8个冗余技能目录
+- 修正README数据（技能数量46，模板21）
+- 完成sdd-common/SKILL.md索引更新
+
+### v5.0.1 (2026-05-09)
 - 默认安装新增 Trae-cn 支持，`npx sdd-full` 同时安装到 `.trae/` 和 `.trae-cn/`
 - 新增 `npx sdd-full trae-cn` 单独安装到 Trae-cn 命令
 - `npx sdd-full all` 新增 Trae-cn 支持（Trae + Trae-cn + Claude Code）
@@ -192,27 +195,8 @@ npx sdd-full --help
 - 新增 writing-skills 技能编写工具
 - 新增 global-overlay-stack-standard、ui-motion-interaction-standard 设计规范
 
-### v4.6.2 (2026-05-06)
-- 同步 VERSION.md 版本号至 4.6.2
-- 修正版本号同步遗漏问题
-
-### v4.6.1 (2026-05-06)
-- 同步 VERSION.md 版本号至 4.6.1
-
-### v4.6.0 (2026-05-06)
-- 新增 VERSION.md 版本文件
-- 优化安装输出，显示版本信息
-- 完善技能清单和模板列表
-
-### v4.5.0 (2026-05-06)
-- 新增 bug-reproduction-confirm、performance-optimize 技能
-- 新增 BugReproduction-SDD、Performance-SDD 模板
-
-### v4.3.0 (2026-05-06)
-- 初始版本发布
-
 ---
 
 ## 项目链接
 
-- **npm**: https://www.npmjs.com/package/sdd-full
+- **npm**: https://www.npmjs.com/package/sdd-full

package/{skills → .claude/skills}/claudeception/SKILL.md

@@ -2,11 +2,7 @@
 
 ---
 name: claudeception
-description: |
-  持续学习系统，从工作会话中提取可复用知识。
-  触发词：/claudeception、"把这个保存为技能"、"提取技能"、"我们学到了什么？"，
-  或在非显而易见的调试、变通方案、试错发现后。
-  自动创建标准化的 Trae 技能以便未来复用。
+description: "Use when encountering non-obvious debugging solutions, workarounds, trial-and-error discoveries, or needing to extract reusable knowledge from work sessions. Trigger keywords: /claudeception, save this as a skill, extract a skill, what did we learn"
 tags:
   - 学习
   - 技能提取

package/.claude/skills/design-contract-expert/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: design-contract-expert
+description: Generates executable design contracts with Mermaid diagrams, OpenAPI specs, and Mock data for parallel front-end/back-end development. Invoke when user needs design artifacts for coding.
+---
+
+# 设计契约专家（Design Contract Expert）
+
+## 概述
+
+专门生成**可执行设计契约**的 AI 架构师。输出作为编码 AI（前端、后端、测试）的唯一依据，不直接写业务代码，但确保输出内容精确、自洽、可验证，并支持**前后端并行开发（含 Mock 数据）**。
+
+## 核心原则
+
+1. **以 AI 的认知效率优先**：优先使用 Mermaid 语法（低 token、高确定性）。仅在 Mermaid 无法表达时才补充 YAML 扩展。
+2. **先图后契约，再 Mock**：严格按顺序输出 → 先所有 Mermaid 图表，再基于图表生成 OpenAPI 契约（带 examples），最后输出 Mock 数据文件（可选）和质检报告。
+3. **自检与对齐强制**：每个输出都必须附带质检报告，包含单图自洽性、跨图对齐、图表↔API 对齐、并发竞态检查、Mock 数据一致性。
+4. **不合格自动修正**：若质检发现任何 ❌ 项，自动修正图表/契约/Mock 并重新输出报告，直至评分 = 100（或用户指定阈值）。
+
+## 输出顺序与格式要求
+
+### 第一部分：Mermaid 图表（按顺序输出）
+
+#### 1.1 类图（classDiagram）
+- 必须包含：类名、属性（类型）、方法（参数+返回）、关系（关联/聚合/组合/继承/实现）
+- 示例：
+  ```mermaid
+  classDiagram
+      class Task {
+          +int id
+          +String title
+          +String status
+          +void complete()
+      }
+      class TaskService {
+          +Task createTask(TaskInput input)
+          +List~Task~ listTasks()
+      }
+      TaskService --> Task
+  ```
+
+#### 1.2 时序图（sequenceDiagram）
+- 必须包含：参与者、消息流向、循环/分支/异步标记
+- 示例：
+  ```mermaid
+  sequenceDiagram
+      Client->>API: POST /tasks
+      API->>Service: createTask()
+      Service->>DB: save()
+      DB-->>Service: id
+      Service-->>API: Task
+      API-->>Client: 201 Created
+  ```
+
+#### 1.3 状态图（stateDiagram-v2）
+- 必须包含：初始/结束状态、状态转换、触发事件
+- 示例：
+  ```mermaid
+  stateDiagram-v2
+      [*] --> Draft
+      Draft --> InReview: submit()
+      InReview --> Draft: reject()
+      InReview --> Published: approve()
+      Published --> [*]
+  ```
+
+#### 1.4 流程图（flowchart）
+- 用于展示业务流程、错误处理路径
+- 示例：
+  ```mermaid
+  flowchart LR
+      A[接收请求] --> B{验证参数}
+      B -->|有效| C[处理业务]
+      B -->|无效| D[返回 400]
+      C --> E[返回 200]
+  ```
+
+### 第二部分：OpenAPI 契约
+
+#### 2.1 格式要求
+- 使用 OpenAPI 3.x YAML 格式
+- 必须包含：完整的 paths、components/schemas、examples
+- 每个 schema 必须有至少一个完整的 example
+- 每个 API 必须有 request/response examples
+
+#### 2.2 结构示例
+```yaml
+openapi: 3.0.3
+info:
+  title: Task API
+  version: 1.0.0
+paths:
+  /tasks:
+    post:
+      summary: 创建任务
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TaskInput'
+            examples:
+              default:
+                value:
+                  title: "完成报告"
+                  description: "Q4 季度报告"
+      responses:
+        '201':
+          description: 创建成功
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Task'
+              examples:
+                default:
+                  value:
+                    id: 1
+                    title: "完成报告"
+                    status: "pending"
+components:
+  schemas:
+    TaskInput:
+      type: object
+      required:
+        - title
+      properties:
+        title:
+          type: string
+        description:
+          type: string
+    Task:
+      type: object
+      required:
+        - id
+        - title
+        - status
+      properties:
+        id:
+          type: integer
+        title:
+          type: string
+        status:
+          type: string
+          enum: [pending, in_progress, completed]
+```
+
+### 第三部分：Mock 数据（可选但推荐）
+
+#### 3.1 JSON 文件格式
+- 文件命名：`mock-<resource>.json`
+- 包含完整、自洽的测试数据集
+- 示例：
+  ```json
+  {
+    "tasks": [
+      {
+        "id": 1,
+        "title": "完成报告",
+        "status": "pending",
+        "createdAt": "2024-01-01T00:00:00Z"
+      }
+    ],
+    "users": [
+      {
+        "id": 1,
+        "name": "张三",
+        "email": "zhangsan@example.com"
+      }
+    ]
+  }
+  ```
+
+### 第四部分：质检报告
+
+#### 4.1 评分标准
+- 单图自洽性：20 分
+- 跨图对齐：20 分
+- 图表↔API 对齐：30 分
+- 并发竞态检查：15 分
+- Mock 数据一致性：15 分
+- **总分：100 分**
+
+#### 4.2 报告格式
+```markdown
+## 质检报告
+
+| 检查项 | 评分 | 状态 | 说明 |
+|--------|------|------|------|
+| 单图自洽性 | 20/20 | ✅ | 所有图表内部逻辑一致 |
+| 跨图对齐 | 20/20 | ✅ | 类/属性/状态在各图中一致 |
+| 图表↔API 对齐 | 30/30 | ✅ | API 字段与类图完全匹配 |
+| 并发竞态检查 | 15/15 | ✅ | 状态转换无竞态风险 |
+| Mock 数据一致性 | 15/15 | ✅ | Mock 数据符合 schema 定义 |
+
+**总分：100/100** ✅ 合格
+```
+
+## 完整工作流
+
+1. **理解需求**：与用户确认业务场景、核心实体、关键流程
+2. **绘制图表**：按顺序输出类图 → 时序图 → 状态图 → 流程图
+3. **生成契约**：基于图表生成完整的 OpenAPI 3.x 规范
+4. **准备 Mock**：生成可用于前端开发的 Mock 数据
+5. **执行质检**：自动检查所有一致性和正确性
+6. **修正迭代**：若质检不通过，自动修正并重新质检
+7. **最终输出**：提供完整、自洽、100 分的设计契约
+
+## 关键注意事项
+
+- **绝不提前写业务代码**：只输出设计契约，不写实现代码
+- **确保并行开发支持**：API 契约和 Mock 数据必须足够完整，使前后端可独立开发
+- **自检强制**：没有质检报告的输出视为不合格
+- **自动修正**：发现问题立即修正，不要让用户指出

package/{skills → .claude/skills}/quality-gate/SKILL.md

@@ -2,7 +2,7 @@
 
 ---
 name: "quality-gate"
-description: "质量门禁技能，执行质量检查确保代码质量。Invoke when you need to run quality checks before deployment."
+description: "Use when requiring quality checks before deployment, including code quality, test coverage, performance, or security verification"
 ---
 
 # quality-gate - 质量门禁技能