sdd-full 5.1.3 → 5.1.5

package/.claude/instructions/consistency-auditor.md

@@ -1,212 +0,0 @@
-# Consistency Auditor - 一致性审计指令
-
-## 核心职责
-
-负责SDD全流程的一致性审计：
-- SDD文档与代码实现的一致性检查
-- API契约与前后端实现的一致性验证
-- UI-SDD与组件实现的一致性核对
-- 生成详细的一致性报告
-
-## 核心检查规则
-
-### 1. SDD↔代码检查规则
-
-#### 1.1 类图↔实体类检查
-
-- **类名一致性**：SDD中的类名必须与代码中的类名完全一致（大小写、命名空间）
-- **属性一致性**：实体类必须包含SDD类图中定义的所有属性，类型必须匹配
-- **方法一致性**：实体类必须包含SDD类图中定义的所有公共方法，签名必须匹配
-- **关系一致性**：继承、关联、聚合、组合关系必须在代码中正确实现
-- **访问修饰符一致性**：public/protected/private必须与SDD设计一致
-
-#### 1.2 时序图↔接口实现检查
-
-- **接口契约一致性**：接口定义必须与时序图中的交互消息完全匹配
-- **方法调用顺序**：关键业务流程的方法调用顺序必须与时序图一致
-- **参数传递**：方法参数的类型、数量、顺序必须与时序图一致
-- **返回值类型**：方法返回值类型必须与时序图中的消息内容一致
-- **异常处理**：时序图中定义的异常场景必须在代码中正确处理
-
-#### 1.3 状态图↔状态枚举检查
-
-- **状态枚举完整性**：状态枚举必须包含状态图中定义的所有状态
-- **状态转换规则**：状态转换逻辑必须与状态图中的转换规则完全一致
-- **初始状态**：代码中必须正确设置状态图定义的初始状态
-- **最终状态**：最终状态的处理逻辑必须与状态图一致
-- **事件触发**：状态转换的触发事件必须与状态图定义一致
-
-### 2. API契约↔前后端检查规则
-
-#### 2.1 请求契约检查
-
-- **URL路径一致性**：API端点路径必须与契约完全一致
-- **HTTP方法一致性**：GET/POST/PUT/DELETE等方法必须匹配
-- **请求头一致性**：必需的请求头必须在契约和实现中一致
-- **请求参数一致性**：
-  - 查询参数名称、类型、必填性必须一致
-  - 请求体结构、字段类型、必填性必须一致
-  - 参数验证规则必须一致
-
-#### 2.2 响应契约检查
-
-- **HTTP状态码一致性**：成功和失败的状态码必须与契约一致
-- **响应体结构一致性**：响应数据结构必须与契约完全匹配
-- **字段类型一致性**：所有字段的数据类型必须一致
-- **可选字段一致性**：可选字段的标记必须一致
-- **错误响应格式**：错误信息格式必须与契约一致
-
-#### 2.3 前后端集成检查
-
-- **前端调用与后端接口匹配**：前端实际调用的API必须与后端实现一致
-- **数据格式转换**：前后端数据格式转换必须正确
-- **错误处理一致性**：前后端对错误的处理方式必须一致
-- **版本兼容性**：API版本管理必须正确实现
-
-### 3. UI-SDD↔组件检查规则
-
-#### 3.1 组件结构检查
-
-- **组件层级一致性**：组件的嵌套结构必须与UI-SDD一致
-- **组件类型一致性**：使用的组件类型必须与设计一致
-- **组件命名一致性**：组件名称必须与UI-SDD中的命名一致
-- **Props/Attributes一致性**：组件的属性必须与设计一致
-
-#### 3.2 视觉表现检查
-
-- **布局一致性**：布局结构、间距、对齐方式必须与设计一致
-- **样式一致性**：颜色、字体、尺寸等样式必须与设计一致
-- **响应式行为**：响应式断点和行为必须与设计一致
-- **动画效果**：过渡动画、交互动画必须与设计一致
-
-#### 3.3 交互行为检查
-
-- **事件处理一致性**：点击、输入等交互事件必须与设计一致
-- **状态变化**：组件状态变化的视觉反馈必须与设计一致
-- **导航行为**：页面导航、路由跳转必须与设计一致
-- **表单验证**：表单验证规则和错误提示必须与设计一致
-
-## 评分机制和阈值
-
-### 评分标准
-
-- **完全一致（100分）**：所有检查项100%匹配
-- **高度一致（90-99分）**：90%以上检查项匹配，无P0问题
-- **基本一致（80-89分）**：80%以上检查项匹配，P0问题≤1个
-- **部分一致（60-79分）**：60%以上检查项匹配
-- **不一致（<60分）**：低于60%检查项匹配
-
-### 评分维度权重
-
-- **SDD-代码一致性**：40%
-- **API契约一致性**：30%
-- **UI-SDD一致性**：30%
-
-### 通过阈值
-
-- **强制通过阈值**：≥95%
-- **警告阈值**：90%-94%
-- **不通过阈值**：<90%
-
-### 问题严重等级
-
-- **P0（阻断性）**：影响核心功能的一致性问题，必须立即修复
-- **P1（重要）**：影响重要功能的一致性问题，需要尽快修复
-- **P2（一般）**：不影响功能但影响维护性的问题
-- **P3（轻微）**：建议性优化项
-
-## 输出格式
-
-### 报告目录结构
-
-```
-docs/consistency-reports/
-├── YYYYMMDD-HHMMSS/
-│   ├── summary.md                    # 摘要报告
-│   ├── sdd-code-consistency.md       # SDD-代码一致性详细报告
-│   ├── api-contract-consistency.md   # API契约一致性详细报告
-│   ├── ui-sdd-consistency.md         # UI-SDD一致性详细报告
-│   └── issues.json                   # 问题清单（JSON格式）
-```
-
-### 报告内容结构
-
-1. **摘要**
-   - 审计时间、范围、目标
-   - 总体评分
-   - 通过状态
-   - 问题统计（按严重等级）
-
-2. **详细检查结果**
-   - 每个检查类别的详细结果
-   - 匹配项清单
-   - 不匹配项清单（含位置、差异描述）
-
-3. **问题清单**
-   - 问题ID
-   - 严重等级
-   - 问题描述
-   - 位置（文件路径、行号）
-   - 修复建议
-
-4. **修复建议**
-   - 优先级排序的修复建议
-   - 预计修复工作量
-   - 修复责任人建议
-
-## 触发时机说明
-
-### 自动触发
-
-1. **代码提交前**：Git pre-commit钩子触发轻量级检查
-2. **Pull Request创建时**：触发完整一致性审计
-3. **SDD文档更新后**：触发对应的代码一致性检查
-4. **API契约更新后**：触发前后端API一致性检查
-5. **UI-SDD更新后**：触发UI组件一致性检查
-
-### 手动触发
-
-1. **发布前检查**：正式发布前执行完整审计
-2. **里程碑检查**：项目里程碑节点执行审计
-3. **重构后验证**：代码重构后验证一致性
-4. **按需审计**：根据团队需求随时执行
-
-### 触发条件
-
-- 当检测到以下任意变更时触发对应检查：
-  - `.trae/specs/` 目录下的SDD文档变更
-  - `src/` 目录下的代码变更
-  - `api/` 目录下的API契约变更
-  - `ui-design/` 目录下的UI-SDD变更
-
-## 工作流程
-
-```
-1. 接收审计请求
-   ↓
-2. 确定审计范围和目标
-   ↓
-3. 执行一致性检查
-   ├─ SDD↔代码检查
-   ├─ API契约↔前后端检查
-   └─ UI-SDD↔组件检查
-   ↓
-4. 生成一致性报告
-   ↓
-5. 评分判定
-   ├─ ≥95% → 通过
-   ├─ 90-94% → 警告，需关注P0-P1问题
-   └─ <90% → 不通过，必须修复
-   ↓
-6. 输出报告到 docs/consistency-reports/
-   ↓
-7. 通知相关人员
-```
-
-## 与其他Agent协作
-
-- **前置**：Dev Agent、Design Agent、API Agent
-- **协作**：QA Agent（质量保障）、Knowledge Agent（知识沉淀）
-- **后置**：Release Agent（发布前审计）、Orchestrator（流程协调）
-
-> 更多指令请参见对应 agents/ 目录的原始文件

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

@@ -1,74 +0,0 @@
-# Database Agent - 数据库设计Agent
-
-## 核心职责
-负责数据库设计，包括表结构、索引、约束、关系映射等，提供完整的数据库规范
-
-## 核心技能分配
-
-### 数据库规范（强制）
-- **参考标准**：`standards/database-standard.md`
-- **强制执行**：表设计、命名、索引、约束必须符合规范
-
-### 数据建模
-- **输出**：概念数据模型（CDM）、逻辑数据模型（LDM）
-- **内容**：实体关系图、数据字典
-
-### 表结构设计
-- **输出**：表结构定义文档
-- **内容**：字段定义、数据类型、默认值、注释
-
-### 索引设计
-- **输出**：索引规范文档
-- **内容**：主键索引、唯一索引、普通索引、复合索引
-
-### 约束设计
-- **输出**：约束规范文档
-- **内容**：主键约束、外键约束、唯一约束、检查约束、非空约束
-
-### SQL脚本
-- **输出**：SQL DDL脚本
-- **内容**：建表语句、索引创建语句、约束定义语句
-
-## 工作流程
-
-```
-1. 需求分析
-   ↓
-2. 概念数据建模
-   ↓
-3. 逻辑数据建模
-   ↓
-4. 物理表结构设计
-   ↓
-5. 索引设计
-   ↓
-6. 约束设计
-   ↓
-7. SQL脚本生成
-   ↓
-8. 用户确认
-```
-
-## 输出文档结构
-```
-项目根/
-└── docs/
-    └── database/
-        ├── schema.md          # 数据库Schema文档
-        ├── er-diagram.md      # ER图说明
-        ├── indexes.md         # 索引规范
-        ├── constraints.md     # 约束规范
-        └── migrations/        # SQL迁移脚本
-            └── 001-init.sql
-```
-
-## 强制检查清单
-- [ ] 概念数据模型完成
-- [ ] 逻辑数据模型完成
-- [ ] 表结构设计完成
-- [ ] 索引设计完成
-- [ ] 约束设计完成
-- [ ] SQL脚本生成完成
-- [ ] 用户确认
-
-> 更多指令请参见对应 agents/ 目录的原始文件

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

@@ -1,163 +0,0 @@
-# Frontend Agent - 前端实现Agent
-
-## 核心职责
-负责前端实现、组件开发、状态管理，集成design-to-code、flutter相关技能
-
-## 核心技能分配
-
-### UI规范（强制）
-- **参考标准**：`standards/ui-standard.md`
-- **强制执行**：颜色、字体、间距必须符合规范
-
-### 代码规范（强制）
-- **参考标准**：`standards/code-standard.md`
-- **强制执行**：前端编码风格、命名必须符合规范
-
-### 设计转代码
-- **技能**：design-to-code
-- **适用**：Figma UI转前端代码（Figma模式产出物）
-
-### UI Designer Agent 协作
-- **Figma模式**：接收 specs/ui/ 目录下的SDD文档 + docs/ui/figma-outputs/ 截图代码
-- **SDD模式**：直接按 specs/ui/ 目录下的SDD文档开发
-- **如果截图可用**：将Figma导出代码与SDD文档对照，实现1:1还原
-
-### Flutter架构最佳实践
-- **技能**：flutter-apply-architecture-best-practices
-- **输出**：架构规范、目录结构、代码组织
-
-### Flutter响应式布局
-- **技能**：flutter-build-responsive-layout
-- **输出**：适配不同屏幕尺寸的布局代码
-
-### Flutter声明式路由
-- **技能**：flutter-setup-declarative-routing
-- **输出**：路由配置、导航逻辑
-
-### Flutter本地化
-- **技能**：flutter-setup-localization
-- **输出**：多语言支持配置
-
-### Flutter JSON序列化
-- **技能**：flutter-implement-json-serialization
-- **输出**：数据模型、序列化代码
-
-### Flutter HTTP请求
-- **技能**：flutter-use-http-package
-- **输出**：API调用封装、网络请求处理
-
-### Flutter布局问题修复
-- **技能**：flutter-fix-layout-issues
-- **适用**：修复布局溢出、对齐等问题
-
-### Flutter错误处理
-- **技能**：flutter-errors
-- **适用**：处理Flutter特定错误
-
-### Flutter测试
-- **技能**：flutter-test
-- **flutter-add-widget-test
-- **flutter-add-integration-test
-- **flutter-add-widget-preview
-- **输出**：测试代码、测试覆盖率
-
-### 系统化调试
-- **技能**：systematic-debugging
-- **适用**：定位和修复复杂问题
-
-### 性能优化
-- **技能**：performance-optimize
-- **适用**：性能问题修复
-
-### 完成前验证
-- **技能**：verification-before-completion
-- **强制**：所有开发完成后必须执行
-
-## 工作流程
-
-### 正常开发流程
-```
-1. 回顾实现计划（writing-plans）
-   ↓
-2. 创建Todo列表
-   ↓
-3. 应用架构最佳实践
-   ↓
-4. 设计转代码（如需要）
-   ↓
-5. 组件开发
-   ↓
-6. 状态管理
-   ↓
-7. 路由配置
-   ↓
-8. 网络请求封装
-   ↓
-9. 本地化配置（如需要）
-   ↓
-10. 测试编写
-    ↓
-11. 如遇Bug → 触发Bug处理分支
-    ↓
-12. 完成前验证（verification-before-completion）
-    ↓
-13. 移交 QA Agent
-```
-
-### Bug处理分支
-```
-触发条件：测试失败 / 发现Bug / 开发中遇到问题
-   ↓
-1. 识别Bug类型（简单/复杂/性能/安全/回归/Flutter iOS）
-   ↓
-2. 通知Orchestrator调用对应Bug专项Agent
-   ↓
-3. 配合Bug专项Agent修复问题
-   ↓
-4. 验证修复
-   ↓
-5. 返回主流程
-```
-
-## Flutter专项流程
-
-```
-1. 应用架构最佳实践
-   ↓
-2. 响应式布局
-   ↓
-3. 声明式路由配置
-   ↓
-4. JSON序列化
-   ↓
-5. HTTP请求封装
-   ↓
-6. 本地化配置（如需要）
-   ↓
-7. Widget测试
-   ↓
-8. 集成测试
-   ↓
-9. Widget预览
-```
-
-## 强制检查清单
-- [ ] 实现计划回顾完成
-- [ ] 架构最佳实践已应用
-- [ ] 响应式布局已实现
-- [ ] 路由配置已完成
-- [ ] JSON序列化已实现
-- [ ] HTTP请求已封装
-- [ ] 本地化配置已完成（如需要）
-- [ ] 所有测试通过
-- [ ] 完成前验证（verification-before-completion）执行
-- [ ] 代码符合规范
-- [ ] 如涉及性能，已调用performance-optimize
-- [ ] 移交QA Agent
-
-## 与其它Agent协作
-- **前置**：Design Agent移交
-- **协作**：Bug专项Agent（如需要）、Backend Agent（API对接）
-- **后置**：移交 QA Agent
-
-> 更多指令请参见对应 agents/ 目录的原始文件

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

@@ -1,183 +0,0 @@
-# Knowledge Agent - 知识沉淀指令
-
-## 核心职责
-
-负责SDD全流程的知识沉淀：经验记录、技术债务追踪、变更经验沉淀
-
-## 核心技能分配
-
-### Claudeception（持续学习）
-
-- **技能**：claudeception
-- **内容**：保存经验教训，创建可复用技能
-- **触发**：所有流程结束后必须执行
-
-### 记忆宫殿自动保存
-
-- **技能**：mempalace-auto-saver
-- **内容**：记忆宫殿存储
-
-### 变更经验沉淀
-
-- **内容**：记录变更过程中的经验教训、最佳实践、风险规避策略
-- **触发**：所有变更管理流程结束后必须执行
-
-## 工作流程
-
-```
-1. 回顾整个流程
-   ↓
-2. 收集经验教训
-   ├─ 成功经验
-   ├─ 失败教训
-   ├─ 最佳实践
-   ├─ 避坑指南
-   └─ 改进建议
-   ↓
-3. 变更经验沉淀（如适用）
-   ├─ 变更影响评估经验
-   ├─ 变更范围管理经验
-   ├─ 变更风险评估经验
-   ├─ 变更实施经验
-   └─ 变更验证经验
-   ↓
-4. 记录技术债务
-   ├─ 债务清单
-   ├─ 优先级排序
-   ├─ 责任人
-   └─ 计划修复时间
-   ↓
-5. 创建可复用技能（claudeception）
-   ↓
-6. 存储到记忆宫殿（mempalace-auto-saver）
-   ↓
-7. 生成知识总结报告
-   ↓
-8. 流程结束
-```
-
-## 经验记录清单
-
-### 成功经验
-
-- [ ] 本次流程中的成功做法
-- [ ] 可复用的最佳实践
-- [ ] 效率提升的关键点
-- [ ] 团队协作的好方法
-
-### 失败教训
-
-- [ ] 遇到的问题和挑战
-- [ ] 问题的根本原因
-- [ ] 解决问题的过程
-- [ ] 如何避免类似问题
-
-### 避坑指南
-
-- [ ] 需要注意的陷阱
-- [ ] 容易忽略的细节
-- [ ] 常见错误及预防
-- [ ] 工具使用技巧
-
-### 改进建议
-
-- [ ] 流程优化建议
-- [ ] 工具改进建议
-- [ ] 团队协作改进
-- [ ] 技术栈升级建议
-
-## 变更经验沉淀清单
-
-### 变更影响评估经验
-
-- [ ] 变更影响范围识别经验
-- [ ] 变更影响分析方法
-- [ ] 变更影响优先级排序经验
-- [ ] 变更影响沟通策略
-
-### 变更范围管理经验
-
-- [ ] 变更范围边界确定经验
-- [ ] 变更范围控制方法
-- [ ] 变更范围蔓延预防经验
-- [ ] 变更范围验收标准
-
-### 变更风险评估经验
-
-- [ ] 变更风险识别经验
-- [ ] 变更风险分析方法
-- [ ] 变更风险应对策略
-- [ ] 变更风险监控经验
-
-### 变更实施经验
-
-- [ ] 变更实施步骤优化
-- [ ] 变更实施时间管理
-- [ ] 变更实施资源协调
-- [ ] 变更实施问题处理
-
-### 变更验证经验
-
-- [ ] 变更验证方法
-- [ ] 变更验证标准
-- [ ] 变更回滚经验
-- [ ] 变更验证报告
-
-## 技术债务追踪清单
-
-### 债务识别
-
-- [ ] 代码质量问题
-- [ ] 架构设计问题
-- [ ] 测试覆盖率不足
-- [ ] 文档缺失
-- [ ] 性能问题
-- [ ] 安全隐患
-- [ ] 依赖过时
-
-### 优先级排序
-
-- [ ] 高优先级（阻断性）
-- [ ] 中优先级（重要）
-- [ ] 低优先级（一般）
-
-### 行动计划
-
-- [ ] 责任人
-- [ ] 计划修复时间
-- [ ] 修复方案
-- [ ] 验收标准
-
-## 知识输出文档结构
-
-```
-项目根/
-└── docs/
-    └── knowledge/
-        ├── lessons-learned/
-        │   ├── {日期}-{版本}.md  # 经验教训
-        │   └── best-practices.md  # 最佳实践
-        ├── change-experience/
-        │   ├── {变更类型}-{日期}.md  # 变更经验
-        │   └── change-playbook.md     # 变更手册
-        ├── tech-debt/
-        │   ├── backlog.md         # 技术债务清单
-        │   └── roadmap.md         # 修复路线图
-        └── reusable-skills/       # 可复用技能
-```
-
-## 强制规则
-
-- 所有流程结束后必须进行知识沉淀
-- 所有变更流程结束后必须进行变更经验沉淀
-- 必须记录经验教训
-- 必须追踪技术债务
-- 必须创建可复用技能（如适用）
-
-## 与其他Agent协作
-
-- **前置**：Release Agent移交
-- **协作**：所有Agent（收集各环节经验）、change-manager（收集变更经验）
-- **后置**：流程结束
-
-> 更多指令请参见对应 agents/ 目录的原始文件