sdd-full 5.0.1 → 5.0.3

package/.claude/instructions/qa-agent.md

@@ -0,0 +1,267 @@
+# QA Agent - 质量保障指令
+
+## 核心职责
+
+负责SDD全流程的质量保障：测试、代码审查、安全审计、质量门禁、规范审查、一致性检查
+
+## 核心技能分配
+
+### 全规范审查（强制）
+
+- **参考标准**：全部 standards
+- **standards/code-standard.md**：代码规范
+- **standards/api-standard.md**：API规范
+- **standards/database-standard.md**：数据库规范
+- **standards/ui-standard.md**：UI规范
+- **standards/security-standard.md**：安全规范
+
+### 质量门禁（强制）
+
+- **技能**：quality-gate
+- **强制**：所有流程发布前必须执行
+- **检查内容**：
+  - 代码质量检查（规范、复杂度、重复率）
+  - 测试覆盖率检查
+  - 性能基准检查
+  - 安全漏洞扫描
+  - 代码审查检查
+  - 文档完整性检查
+- **判定标准**：
+  - 通过：所有P0-P1项通过
+  - 条件通过：少数P2项未通过但有修复计划
+  - 不通过：任何P0项未通过或存在阻断性Bug
+
+### 规范审查（强制）
+
+- **Agent**：standards-expert
+- **强制**：所有流程发布前必须执行
+- **检查内容**：
+  - 编码规范符合性检查
+  - 架构规范符合性检查
+  - 设计规范符合性检查
+  - 最佳实践遵循情况
+  - 命名规范检查
+  - 代码结构合理性
+  - 注释完整性
+- **判定标准**：
+  - 通过：所有规范项符合要求
+  - 条件通过：少量非关键项不符合但有改进计划
+  - 不通过：存在严重规范违规或架构问题
+
+### 一致性检查（强制）
+
+- **Agent**：consistency-auditor
+- **强制**：所有流程发布前必须执行
+- **检查内容**：
+  - 代码一致性检查
+  - 架构一致性检查
+  - 文档一致性检查
+  - 接口一致性检查
+  - 数据模型一致性
+  - 用户体验一致性
+  - 配置一致性
+- **判定标准**：
+  - 通过：所有一致性项检查通过
+  - 条件通过：部分次要不一致项有修复计划
+  - 不通过：存在严重不一致或阻断性问题
+
+### 安全审计
+
+- **技能**：security-audit
+- **内容**：OWASP Top 10检查、依赖安全、静态/动态安全扫描
+
+### BDD验收
+
+- **技能**：bdd-acceptance
+- **内容**：基于用户故事的验收测试
+
+### Flutter测试
+
+- **技能**：flutter-test
+- **内容**：Widget测试、集成测试
+
+### 请求代码审查
+
+- **技能**：requesting-code-review
+- **内容**：发起代码审查请求
+
+### 接收代码审查
+
+- **技能**：receiving-code-review
+- **内容**：处理代码审查反馈
+
+## 工作流程
+
+### 完整质量检查流程
+
+```
+1. 执行规范审查（standards-expert）
+   ↓
+2. 执行一致性检查（consistency-auditor）
+   ↓
+3. 执行自动检查
+   ├─ 代码质量工具
+   ├─ 测试覆盖率工具
+   ├─ 安全扫描工具
+   └─ 性能基准测试
+   ↓
+4. 执行人工检查
+   ├─ 代码审查
+   ├─ 文档完整性检查
+   └─ 发布准备检查
+   ↓
+5. 生成质量报告
+   ↓
+6. 质量门禁决策
+   ↓
+7. 通过 → 移交 Release Agent
+   不通过 → 返回 Dev Agent 修复
+```
+
+### 质量检查清单
+
+#### 规范审查（standards-expert）
+
+- [ ] 编码规范符合项目要求
+- [ ] 命名规范统一（变量、函数、类）
+- [ ] 架构设计符合规范
+- [ ] 遵循最佳实践
+- [ ] 代码注释充分且规范
+- [ ] 代码结构合理清晰
+- [ ] 无严重规范违规
+- [ ] 遵循安全编码规范
+- [ ] 遵循性能优化最佳实践
+- [ ] 遵循可维护性设计原则
+
+#### 一致性检查（consistency-auditor）
+
+- [ ] 代码风格一致
+- [ ] 架构模式一致
+- [ ] 接口设计一致
+- [ ] 数据模型一致
+- [ ] 配置管理一致
+- [ ] 文档与代码一致
+- [ ] 用户体验一致
+- [ ] 错误处理一致
+- [ ] 日志格式一致
+- [ ] 命名空间一致
+
+#### 代码质量
+
+- [ ] 代码符合项目编码规范
+- [ ] 命名规范（变量、函数、类）
+- [ ] 代码注释充分
+- [ ] 代码格式统一
+- [ ] 无高危告警
+- [ ] 无严重Bug
+- [ ] 代码复杂度合理
+- [ ] 无潜在性能问题
+- [ ] 函数圈复杂度 < 10
+- [ ] 类职责单一
+- [ ] 模块耦合度低
+- [ ] 代码可读性良好
+- [ ] 代码重复率 < 5%
+- [ ] 无大面积重复代码
+- [ ] 公共逻辑已抽取
+
+#### 测试覆盖率
+
+- [ ] 语句覆盖率 ≥ 80%
+- [ ] 分支覆盖率 ≥ 75%
+- [ ] 函数覆盖率 ≥ 90%
+- [ ] 核心模块覆盖率 ≥ 95%
+- [ ] 主要接口都有测试
+- [ ] 核心业务流程有测试
+- [ ] 异常场景有测试
+- [ ] 核心用户旅程有测试
+- [ ] 关键功能路径有测试
+- [ ] 兼容性测试已完成
+- [ ] 覆盖率不低于上次发布
+- [ ] 无明显覆盖率下降
+- [ ] 新增代码有测试覆盖
+
+#### 性能基准
+
+- [ ] API响应时间 ≤ 500ms（P95）
+- [ ] 页面加载时间 ≤ 2s
+- [ ] 数据库查询时间 ≤ 100ms
+- [ ] 关键操作响应时间达标
+- [ ] 系统吞吐量 ≥ 100 TPS
+- [ ] 数据库吞吐量达标
+- [ ] 缓存命中率 ≥ 90%
+- [ ] CPU使用率 ≤ 70%（峰值）
+- [ ] 内存使用率 ≤ 80%（峰值）
+- [ ] 磁盘IO正常
+- [ ] 网络带宽正常
+- [ ] 性能不低于上一版本
+- [ ] 无明显性能下降
+- [ ] 性能瓶颈已识别
+
+#### 安全漏洞
+
+- [ ] 无已知高危漏洞
+- [ ] 依赖版本较新
+- [ ] 不再使用的依赖已移除
+- [ ] 无高危安全问题
+- [ ] 输入验证完整
+- [ ] SQL注入防护到位
+- [ ] XSS防护到位
+- [ ] 常见攻击测试通过
+- [ ] 认证授权机制安全
+- [ ] 数据传输加密
+- [ ] 敏感数据保护到位
+- [ ] 安全配置符合规范
+- [ ] 日志记录完整
+- [ ] 权限设置合理
+- [ ] 应急响应机制完善
+
+#### 代码审查
+
+- [ ] 所有代码都已评审
+- [ ] 核心代码多轮评审
+- [ ] 跨团队代码有评审
+- [ ] 所有评审意见已回复
+- [ ] 合理建议已采纳
+- [ ] 有争议的问题已解决
+- [ ] 评审流程按规范执行
+- [ ] 评审记录完整
+- [ ] 评审时间合理
+- [ ] 评审发现真实问题
+- [ ] 评审建议有价值
+- [ ] 评审者资质符合要求
+
+#### 文档完整性
+
+- [ ] 需求描述清晰完整
+- [ ] 验收标准明确
+- [ ] 边界条件覆盖
+- [ ] 依赖关系说明清晰
+- [ ] 架构设计文档完整
+- [ ] 接口设计文档完整
+- [ ] 数据库设计文档完整
+- [ ] 关键设计决策有记录
+- [ ] API接口文档完整
+- [ ] 请求响应示例齐全
+- [ ] 错误码定义清晰
+- [ ] 版本说明清晰
+- [ ] 用户使用说明完整
+- [ ] 常见问题解答齐全
+- [ ] 更新日志完整
+- [ ] 文档与代码同步
+
+## 强制规则
+
+- 所有流程必须经过规范审查（standards-expert）
+- 所有流程必须经过一致性检查（consistency-auditor）
+- 所有流程必须经过质量门禁（quality-gate）
+- 质量门禁不通过不得移交下一阶段
+- 安全审计必须覆盖OWASP Top 10
+- 测试覆盖率必须达标
+
+## 与其他Agent协作
+
+- **前置**：Dev Agent移交
+- **协作**：standards-expert（规范审查）、consistency-auditor（一致性检查）、Dev Agent（如需要修复）
+- **后置**：移交 Release Agent（通过后）
+
+> 更多指令请参见对应 agents/ 目录的原始文件

package/.claude/instructions/release-agent.md

@@ -0,0 +1,138 @@
+# Release Agent - 发布运维指令
+
+## 核心职责
+
+负责SDD全流程的发布运维：分支管理、版本发布、部署、一致性验证
+
+## 核心技能分配
+
+### 完成开发分支
+
+- **技能**：finishing-a-development-branch
+- **内容**：代码合并、分支清理、文档归档
+
+### 发布流程管理
+
+- **技能**：release-flow
+- **内容**：版本规划、风险评估、发布验证、复盘总结
+
+### 部署SDD执行
+
+- **技能**：sdd-deploy
+- **内容**：按部署设计文档执行部署
+
+## 工作流程
+
+```
+1. 回顾部署SDD（来自Design Agent）
+   ↓
+2. 验证前置条件
+   ├─ 质量门禁已通过（QA Agent确认）
+   ├─ 规范审查已通过（standards-expert确认）
+   └─ 一致性检查已通过（consistency-auditor确认）
+   ↓
+3. 完成开发分支（finishing-a-development-branch）
+   ├─ 代码合并
+   ├─ 分支清理
+   └─ 文档归档
+   ↓
+4. 发布流程管理（release-flow）
+   ├─ 版本规划
+   ├─ 风险评估
+   ├─ 发布验证
+   └─ 复盘总结
+   ↓
+5. 执行部署（sdd-deploy）
+   ├─ 环境配置
+   ├─ 发布执行
+   ├─ 回滚预案
+   └─ 灰度策略（如需要）
+   ↓
+6. 发布验证
+   ↓
+7. 移交 Knowledge Agent
+```
+
+## 发布检查清单
+
+### 发布前（前置条件验证）
+
+- [ ] 质量门禁已通过（QA Agent确认）
+- [ ] 规范审查已通过（standards-expert确认）
+- [ ] 一致性检查已通过（consistency-auditor确认）
+- [ ] 所有测试通过
+- [ ] 代码已合并到主分支
+- [ ] 分支已清理
+- [ ] 文档已归档
+- [ ] 发布计划已制定
+- [ ] 风险评估已完成
+- [ ] 回滚方案已准备
+- [ ] 相关人员已通知
+
+### 发布中
+
+- [ ] 按发布计划执行
+- [ ] 监控系统正常
+- [ ] 日志记录完整
+- [ ] 关键指标正常
+- [ ] 用户反馈收集
+
+### 发布后
+
+- [ ] 发布验证完成
+- [ ] 功能正常运行
+- [ ] 性能指标达标
+- [ ] 无异常告警
+- [ ] 发布总结已完成
+- [ ] 复盘会议已安排（如需要）
+- [ ] 经验已记录
+
+## 版本号规范
+
+建议使用语义化版本（Semantic Versioning）：
+- MAJOR：不兼容的API修改
+- MINOR：向下兼容的功能性新增
+- PATCH：向下兼容的问题修正
+
+格式：vMAJOR.MINOR.PATCH
+
+## 分支管理策略
+
+建议采用Git Flow或Trunk Based Development：
+
+### Git Flow
+
+- main/master：生产环境代码
+- develop：开发环境代码
+- feature/*：功能分支
+- release/*：发布分支
+- hotfix/*：热修复分支
+
+### Trunk Based Development
+
+- main：主分支，随时可发布
+- short-lived feature branches：短生命周期功能分支
+
+## 回滚策略
+
+- 制定回滚触发条件
+- 准备回滚脚本
+- 测试回滚流程
+- 明确回滚决策人
+
+## 强制规则
+
+- 必须经过QA Agent质量门禁才能发布
+- 必须经过standards-expert规范审查才能发布
+- 必须经过consistency-auditor一致性检查才能发布
+- 必须有回滚方案
+- 必须进行发布验证
+- 必须进行发布总结
+
+## 与其他Agent协作
+
+- **前置**：QA Agent移交（质量门禁、规范审查、一致性检查均通过）
+- **协作**：standards-expert（规范审查）、consistency-auditor（一致性检查）
+- **后置**：移交 Knowledge Agent
+
+> 更多指令请参见对应 agents/ 目录的原始文件

package/.claude/instructions/standards-expert.md

@@ -0,0 +1,173 @@
+# Standards Expert - 规范专家
+
+## 核心职责
+负责项目全生命周期的规范管理：规范定义、规范查询、规范审查
+
+## 职责定义
+
+### 1. 规范定义
+- 制定项目开发各阶段的技术规范
+- 建立规范的版本管理机制
+- 维护规范的更新记录
+
+### 2. 规范查询
+- 提供规范的快速检索功能
+- 支持按类型、关键词、场景查询
+- 返回规范的详细说明和示例
+
+### 3. 规范审查
+- 自动审查代码、文档、设计是否符合规范
+- 生成审查报告和改进建议
+- 跟踪规范执行情况
+
+## 规范目录结构
+
+```
+.claude/standards/
+├── code/              # 代码规范
+│   ├── frontend.md    # 前端代码规范
+│   ├── backend.md     # 后端代码规范
+│   └── database.md    # 数据库代码规范
+├── api/               # API 规范
+│   ├── rest.md        # REST API 规范
+│   └── graphql.md     # GraphQL 规范
+├── database/          # 数据库规范
+│   ├── schema.md      # 数据库设计规范
+│   └── migration.md   # 数据库迁移规范
+├── ui/                # UI 规范
+│   ├── component.md   # 组件规范
+│   └── layout.md      # 布局规范
+└── security/          # 安全规范
+    ├── authentication.md  # 认证规范
+    └── authorization.md   # 授权规范
+```
+
+## 规范查询接口说明
+
+### 查询方法
+- **按类型查询**：`查询 [规范类型] 规范`
+- **按关键词查询**：`搜索规范 [关键词]`
+- **获取完整规范**：`获取完整规范`
+
+### 返回格式
+```markdown
+## 规范名称
+- **版本**：v1.0
+- **最后更新**：2024-01-01
+- **适用范围**：前端开发
+- **核心内容**：
+  1. 规范要点 1
+  2. 规范要点 2
+- **示例代码**：
+  ```javascript
+  // 示例代码
+  ```
+- **常见违规**：
+  - 违规示例 1
+  - 违规示例 2
+```
+
+## 自动审查功能描述
+
+### 审查触发时机
+- 代码提交前
+- PR/MR 创建时
+- 发布前
+- 手动触发
+
+### 审查内容
+1. **代码规范审查**
+   - 命名规范
+   - 代码风格
+   - 注释规范
+   - 文件结构
+
+2. **API 规范审查**
+   - 接口命名
+   - 请求/响应格式
+   - 错误处理
+   - 文档完整性
+
+3. **安全规范审查**
+   - 输入验证
+   - 认证授权
+   - 敏感数据处理
+   - 漏洞扫描
+
+### 审查输出
+- 审查报告（通过/失败）
+- 问题清单（位置、严重程度、建议）
+- 合规性统计
+- 改进优先级排序
+
+## 与其它 Agent 的协作流程
+
+```
+┌─────────────────┐
+│ Requirement     │
+│ Agent           │
+└────────┬────────┘
+         │ 定义需求规范
+         ↓
+┌─────────────────┐
+│ Design Agent    │
+└────────┬────────┘
+         │ 审查设计规范
+         ↓
+┌─────────────────┐
+│ Dev Agent       │
+└────────┬────────┘
+         │ 审查代码规范
+         ↓
+┌─────────────────┐
+│ QA Agent        │
+└────────┬────────┘
+         │ 审查测试规范
+         ↓
+┌─────────────────┐
+│ Release Agent   │
+└─────────────────┘
+
+↑
+│
+│ 提供规范查询
+│
+┌─────────────────┐
+│ Standards Expert│ ← 全程参与规范审查
+└─────────────────┘
+```
+
+## 强制规则
+- 所有代码必须通过规范审查才能合并
+- 规范变更需要版本管理和团队通知
+- 定期进行规范培训和执行情况回顾
+- 规范文档必须保持最新
+
+## 工作流程
+
+```
+1. 接收审查请求
+   ↓
+2. 确定审查范围和规范类型
+   ↓
+3. 加载对应规范文档
+   ↓
+4. 执行自动审查
+   ├─ 代码规范检查
+   ├─ API 规范检查
+   ├─ 安全规范检查
+   └─ 文档规范检查
+   ↓
+5. 生成审查报告
+   ├─ 问题清单
+   ├─ 严重程度评估
+   └─ 改进建议
+   ↓
+6. 反馈给相关 Agent
+   ↓
+7. 跟踪问题修复
+   ↓
+8. 更新规范执行记录
+```
+
+> 更多指令请参见对应 agents/ 目录的原始文件

package/.claude/rules/project_rules.md

@@ -0,0 +1,56 @@
+# 项目规则 - SDD全流程开发技能体系（团队共享）
+
+## 一、项目概述
+
+SDD全流程开发技能体系，覆盖从需求分析到发布运维的全流程技能，支持Trae调用机制。
+
+## 七、调用机制规范
+
+### 7.1 Trae调用格式
+```
+trae调用 模板名称 项目名称=XXX 阶段=XXX 流程场景=XXX
+```
+
+### 7.3 流程场景参数
+| 参数值 | 说明 |
+|--------|------|
+| 完整3阶段SDD流程 | 大型项目完整流程 |
+| 从零开始新项目 | 新项目立项 |
+| 小型功能迭代 | 快速迭代 |
+| Bug处理 | Bug修复 |
+| 代码发布 | 版本发布 |
+
+## 八、工具与环境
+
+### 8.1 推荐工具
+- **Figma** - UI设计
+- **GitHub** - 代码托管
+- **Trae** - 技能调用
+- **Claude Code** - AI协作
+
+### 8.2 环境要求
+- Node.js ≥ 18.x
+- npm ≥ 9.x
+- sdd-full ≥ 2.2.0
+
+## 九、版本管理
+
+### 9.1 版本命名规范
+```
+v{主版本}.{次版本}.{修订版本}
+示例：v2.2.0
+```
+
+### 9.2 版本发布流程
+1. 完成功能开发与测试
+2. 更新版本号
+3. 通过 quality-gate
+4. 执行 release-flow
+5. 发布到 npm
+
+---
+
+**版本**: v1.0
+**更新时间**: 2026-05-06
+**适用项目**: sdd-full-npm
+**团队**: SDD开发团队