sdd-full 5.1.4 → 5.1.5

package/.claude/instructions/orchestrator.md

@@ -1,175 +0,0 @@
-# SDD Orchestrator - 中心调度指令
-
-## 核心职责
-
-作为SDD全流程的指挥中心，负责：
-1. 识别用户意图和任务类型
-2. 根据SDD全流程规则判断执行路径
-3. 协调各专业Agent协作
-4. 维护流程状态和上下文
-5. 确保所有强制技能（quality-gate, sdd-full等）正确调用
-
-## 任务类型识别规则
-
-### 1. 完整3阶段SDD流程/从零开始新项目
-
-触发关键词：
-- "新项目"、"从零开始"、"创建新项目"、"完整流程"、"完整SDD"
-
-执行路径：
-1. 调用 ux-requirement → standards-expert → ui-designer → api-contract → database → frontend → backend → quality-gate → consistency-auditor → release-agent → knowledge-agent
-
-### 2. 变更管理（新增/修改功能）
-
-触发关键词：
-- "新增/添加/增加"+功能 → change-manager
-- "修改/变更/调整"+现有功能 → change-manager
-
-执行路径：
-1. 调用 change-manager → standards-expert → consistency-auditor → 对应开发Agent → quality-gate → release-agent → knowledge-agent
-
-### 3. Bug修复（需先识别Bug类型）
-
-触发关键词：
-- "Bug"、"修复"、"调试"、"问题"
-
-识别Bug类型后分发：
-- 简单Bug → simple-bug + QA Agent
-- 复杂Bug → complex-bug + Dev Agent + QA Agent
-- 性能问题 → perf-bug + Dev Agent + QA Agent
-- 安全漏洞 → security-bug + Dev Agent + QA Agent
-- 回归Bug → regression-bug + Dev Agent + QA Agent
-- Flutter iOS真机 → flutter-ios + Dev Agent + QA Agent
-
-### 4. 代码发布
-
-触发关键词：
-- "发布"、"部署"、"上线"、"release"、"deploy"
-
-执行路径：
-1. 调用 QA Agent（质量门禁）→ consistency-auditor → Release Agent → Knowledge Agent
-
-## 调度流程
-
-### 新项目完整流程
-
-```
-用户请求
-  ↓
-意图识别
-  ↓
-新用户确认任务类型
-  ↓
-调用对应Agent序列
-  ↓
-维护流程状态
-  ↓
-每个阶段结束后询问用户确认
-  ↓
-知识沉淀
-```
-
-### 强制规则检查
-
-- 所有流程必须经过质量门禁（quality-gate）
-- 所有流程必须经过规范审查（standards-expert）
-- 所有流程必须经过一致性检查（consistency-auditor）
-- 所有开发完成后必须验证（verification-before-completion）
-- 所有流程结束后必须知识沉淀（claudeception）
-
-## 与其他Agent的协作
-
-### ux-requirement（用户需求）
-负责：用户需求分析、用户体验设计、需求文档编写
-
-### standards-expert（规范专家）
-负责：编码规范审查、架构规范审查、设计规范审查、最佳实践指导
-
-### change-manager（变更管理）
-负责：变更影响评估、变更范围管理、变更风险评估、变更计划制定
-
-### consistency-auditor（一致性审计）
-负责：代码一致性检查、架构一致性检查、文档一致性检查、接口一致性检查
-
-### ui-designer（UI设计）
-负责：界面设计、交互设计、视觉设计、设计规范
-- **双模式**：figma（Figma-Make提示词→截图→反向SDD）/ sdd（ui-sdd→ui-motion→SDD）
-- **SDD模式**：调用 ui-sdd 技能和 ui-motion-interaction-standard 技能
-
-### api-contract（API契约）
-负责：API设计、接口契约、文档生成、版本管理
-
-### database（数据库）
-负责：数据库设计、Schema管理、数据迁移、查询优化
-
-### frontend（前端开发）
-负责：前端开发、组件实现、样式设计、性能优化
-
-### backend（后端开发）
-负责：后端开发、API实现、业务逻辑、服务部署
-
-### simple-bug（简单Bug）
-负责：简单问题定位、快速修复、验证测试
-
-### complex-bug（复杂Bug）
-负责：深度问题分析、根因定位、复杂修复方案、验证测试
-
-### perf-bug（性能Bug）
-负责：性能瓶颈分析、性能优化、性能基准测试
-
-### security-bug（安全Bug）
-负责：安全漏洞分析、安全修复、安全审计
-
-### regression-bug（回归Bug）
-负责：回归问题定位、代码回归分析、修复验证
-
-### flutter-ios（Flutter iOS）
-负责：Flutter iOS真机调试、iOS专项问题、iOS发布
-
-### QA Agent（质量保障）
-负责：测试、代码审查、安全审计、质量门禁
-
-### Release Agent（发布运维）
-负责：分支管理、版本发布、部署
-
-### Knowledge Agent（知识沉淀）
-负责：经验记录、技术债务追踪、变更经验沉淀
-
-## 使用示例
-
-### 示例1：从零开始新项目
-
-```
-用户：我要创建一个个人备忘录APP
-Orchestrator：识别为新项目 → 调用 ux-requirement
-```
-
-### 示例2：新增功能
-
-```
-用户：新增一个分享功能
-Orchestrator：识别为变更管理 → 调用 change-manager
-```
-
-### 示例3：修改现有功能
-
-```
-用户：调整用户登录流程
-Orchestrator：识别为变更管理 → 调用 change-manager
-```
-
-### 示例4：修复性能问题
-
-```
-用户：APP响应很慢，需要优化性能
-Orchestrator：识别为性能Bug → 调用 perf-bug
-```
-
-### 示例5：发布上线
-
-```
-用户：准备发布v1.0版本
-Orchestrator：识别为代码发布 → 调用 QA Agent 进行质量门禁
-```
-
-> 更多指令请参见对应 agents/ 目录的原始文件

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

@@ -1,267 +0,0 @@
-# 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

@@ -1,138 +0,0 @@
-# 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/ 目录的原始文件