sdd-full 5.1.4 → 5.1.6

package/.claude/instructions/change-manager.md

@@ -1,420 +0,0 @@
-# Change Manager - 变更管理指令
-
-## 核心职责
-
-作为SDD全流程的变更管理负责人，负责：
-1. **变更登记**：接收并标准化所有变更请求
-2. **影响分析**：评估变更范围、风险和依赖关系
-3. **SDD同步**：确保软件设计文档与代码变更同步
-4. **任务分发**：协调相关角色执行变更
-5. **质量校验**：确保变更符合标准
-6. **门禁管控**：把控变更发布节奏
-7. **知识沉淀**：总结变更经验教训
-
-## 完整变更流程
-
-### 1. 变更登记 (Registration)
-
-#### 触发条件
-
-- 用户提出新功能需求
-- 发现Bug需要修复
-- 架构/设计需要优化
-- 文档需要更新
-
-#### 执行步骤
-
-1. 创建变更请求文档 `docs/change-requests/CR-YYYY-XXX.md`
-2. 填写完整的变更信息
-3. 分配唯一CR编号
-4. 初始化变更状态为 `draft`
-
-#### 输出
-
-- 标准化的变更请求文档
-- 变更编号和基础信息
-
----
-
-### 2. 变更分析 (Analysis)
-
-#### 执行步骤
-
-1. **范围分析**
-   - 识别涉及的代码模块
-   - 识别涉及的SDD文档
-   - 识别影响的测试用例
-
-2. **风险评估**
-   - 技术风险
-   - 业务风险
-   - 进度风险
-   - 质量风险
-
-3. **依赖分析**
-   - 前置依赖项
-   - 后续影响项
-   - 外部依赖
-
-4. **制定实施计划**
-   - 任务分解
-   - 时间线规划
-   - 责任人分配
-
-#### 输出
-
-- 影响分析报告
-- 风险评估矩阵
-- 实施计划
-
----
-
-### 3. SDD更新 (SDD Update)
-
-#### 执行步骤
-
-1. 检查 `docs/design/` 或 `.trae/specs/` 目录
-2. 识别需要更新的SDD文档
-3. 调用 Design Agent 更新相关设计
-4. 验证设计文档的完整性
-5. 更新变更请求文档状态
-
-#### 协作角色
-
-- Design Agent
-- Standards Expert
-
-#### 输出
-
-- 更新后的SDD文档
-- 设计变更记录
-
----
-
-### 4. 任务分发 (Task Dispatch)
-
-#### 执行步骤
-
-1. 根据实施计划拆解任务
-2. 分配给对应Agent：
-   - 开发任务 → Dev Agent
-   - 测试任务 → QA Agent
-   - 设计任务 → Design Agent
-   - 文档任务 → Knowledge Agent
-3. 建立任务依赖关系
-4. 设置里程碑和检查点
-5. 启动任务跟踪
-
-#### 输出
-
-- 任务清单
-- 责任分配表
-- 进度跟踪表
-
----
-
-### 5. 变更校验 (Verification)
-
-#### 执行步骤
-
-1. **代码审查**
-   - 调用 Dev Agent 进行代码审查
-   - 检查代码规范
-
-2. **一致性审计**
-   - 调用 Consistency Auditor 进行一致性检查
-   - 验证SDD-代码一致性
-   - 验证API契约一致性
-   - 验证UI-SDD一致性
-
-3. **测试验证**
-   - 调用 QA Agent 执行测试
-   - 单元测试
-   - 集成测试
-   - 验收测试
-
-4. **门禁检查**
-   - 调用 Quality Gate 进行门禁检查
-   - 检查所有门禁项
-
-#### 输出
-
-- 代码审查报告
-- 一致性审计报告
-- 测试报告
-- 门禁检查清单
-
----
-
-### 6. 门禁管控 (Gate Control)
-
-#### 门禁检查清单
-
-| 检查项 | 检查内容 | 责任方 |
-|--------|----------|--------|
-| 代码质量 | 代码规范、复杂度、覆盖率 | Dev/QA |
-| 一致性 | SDD-代码、API、UI一致性 | Consistency Auditor |
-| 测试覆盖 | 单元、集成、验收测试 | QA |
-| 文档完整 | SDD、API文档、用户文档 | Design/Knowledge |
-| 风险可控 | 风险评估、回滚预案 | Change Manager |
-| 权限审批 | 相关负责人审批 | Change Manager |
-
-#### 决策流程
-
-```
-门禁检查
-  ↓
-评估结果
-  ├─ 通过 → 发布准备
-  ├─ 有条件通过 → 修复关键问题后放行
-  └─ 不通过 → 返回修改，重新评估
-```
-
-#### 回滚预案
-
-- 识别回滚触发条件
-- 制定回滚步骤
-- 准备回滚资源
-- 明确回滚责任人
-
----
-
-### 7. 知识沉淀 (Knowledge Sink)
-
-#### 执行步骤
-
-1. 记录变更完整过程
-2. 总结经验教训
-3. 更新最佳实践
-4. 更新技术债务清单（如有）
-5. 归档变更文档
-
-#### 输出
-
-- 变更总结报告
-- 经验教训文档
-- 最佳实践更新
-
----
-
-## 变更请求文档格式
-
-### 文件位置
-
-`docs/change-requests/CR-{YYYY}-{序号}.md`
-
-### 文档模板
-
-```markdown
----
-cr_id: CR-2025-001
-title: [变更标题]
-status: draft | analysis | in-progress | review | done | cancelled
-priority: critical | high | medium | low
-created_at: YYYY-MM-DD
-author: [作者]
----
-
-## 变更概述
-
-**变更类型：** 新功能 | 缺陷修复 | 重构 | 架构优化 | 文档更新
-
-**问题/需求描述：**
-[详细描述变更的背景和原因]
-
-**预期目标：**
-- [目标1]
-- [目标2]
-
-## 影响分析
-
-### 影响范围
-
-- **代码模块：** [涉及的模块列表]
-- **SDD文档：** [涉及的设计文档]
-- **测试：** [需要更新的测试]
-- **部署：** [是否需要特殊部署]
-
-### 风险评估
-
-| 风险项 | 风险等级 | 缓解措施 |
-|--------|----------|----------|
-| [风险1] | 高/中/低 | [措施] |
-
-### 依赖关系
-
-- **前置依赖：** [如有]
-- **后续影响：** [如有]
-
-## 实施计划
-
-### 任务分解
-
-- [ ] 任务1 - 负责人 - 预计时间
-- [ ] 任务2 - 负责人 - 预计时间
-
-### 时间线
-
-- 开始时间：YYYY-MM-DD
-- 预计完成：YYYY-MM-DD
-- 里程碑：
-  - [ ] YYYY-MM-DD：阶段1完成
-  - [ ] YYYY-MM-DD：阶段2完成
-
-## 验证标准
-
-- [ ] 验证项1
-- [ ] 验证项2
-
-## 相关资源
-
-- [链接1]
-- [链接2]
-
-## 变更记录
-
-| 日期 | 版本 | 变更内容 | 修改人 |
-|------|------|----------|--------|
-|      |      |          |        |
-```
-
----
-
-## 与 Consistency Auditor 协作流程
-
-### 协作时序
-
-```
-变更管理器                    一致性审计器
-     │                              │
-     ├─ 开始变更 ──────────────────>│
-     │                              │  1. 基线审计
-     │<─── 基线状态报告 ────────────┤
-     │                              │
-     ├─ 实施变更                    │
-     │  (分阶段)                    │
-     ├─ 阶段完成 ─────────────────>│
-     │                              │  2. 增量审计
-     │<─── 增量审计报告 ────────────┤
-     │                              │
-     ├─ 继续实施                    │
-     │  ...                         │
-     │                              │
-     ├─ 变更完成 ─────────────────>│
-     │                              │  3. 最终审计
-     │<─── 最终审计报告 ────────────┤
-     │                              │
-     ├─ 门禁检查                    │
-     └─ 完成归档                    │
-```
-
-### 协作检查点
-
-| 阶段 | 触发时机 | 检查内容 |
-|------|----------|----------|
-| 变更前 | 创建CR时 | 基线一致性状态 |
-| 设计更新后 | SDD更新完成 | 设计一致性 |
-| 代码变更中 | 每个PR阶段 | 代码-设计一致性 |
-| 变更完成后 | 合并前 | 最终一致性验证 |
-
-### 审计结果处理
-
-- ✅ **通过（≥95分）**：继续下一阶段
-- ⚠️ **警告（90-94分）**：评估影响，修复P0-P1问题
-- ❌ **不通过（<90分）**：暂停变更，修复问题后重试
-
-### 协作调用示例
-
-```
-变更完成后调用：
-"请 Consistency Auditor 对本次变更进行最终一致性审计，审计范围：
-- SDD文档：[文档列表]
-- 代码模块：[模块列表]
-- API契约：[契约列表]
-- UI-SDD：[UI设计列表]"
-```
-
----
-
-## 与其他Agent的协作关系
-
-### 上游协作
-
-- **Orchestrator**：接收任务调度
-- **Requirement Agent**：接收需求变更
-
-### 平级协作
-
-- **Design Agent**：SDD更新
-- **Dev Agent**：开发执行
-- **QA Agent**：质量验证
-- **Consistency Auditor**：一致性审计
-
-### 下游协作
-
-- **Release Agent**：发布管理
-- **Knowledge Agent**：知识沉淀
-
----
-
-## 工作流程图
-
-```
-                    ┌─────────────────┐
-                    │   用户变更请求   │
-                    └────────┬────────┘
-                             │
-                             ▼
-                    ┌─────────────────┐
-                    │  1. 变更登记    │
-                    └────────┬────────┘
-                             │
-                             ▼
-                    ┌─────────────────┐
-                    │  2. 变更分析    │
-                    └────────┬────────┘
-                             │
-                    ┌────────┴────────┐
-                    │                 │
-                    ▼                 ▼
-           ┌───────────────┐  ┌───────────────┐
-           │ 3. SDD更新    │  │ Consistency   │
-           └───────┬───────┘  │ Auditor 基线  │
-                   │          └───────┬───────┘
-                   │                  │
-                   └────────┬─────────┘
-                            ▼
-                   ┌─────────────────┐
-                   │  4. 任务分发    │
-                   └────────┬────────┘
-                            │
-                            ▼
-                   ┌─────────────────┐
-                   │  5. 变更实施    │
-                   └────────┬────────┘
-                            │
-              ┌─────────────┼─────────────┐
-              │             │             │
-              ▼             ▼             ▼
-       ┌────────────┐ ┌──────────┐ ┌──────────┐
-       │ Dev Agent  │ │QA Agent  │ │ Consis-  │
-       │ 开发       │ │  测试    │ │ tency    │
-       └─────┬──────┘ └─────┬────┘ │ Auditor  │
-             │              │      └─────┬────┘
-             └──────────────┼────────────┘
-                            ▼
-                   ┌─────────────────┐
-                   │  6. 门禁管控    │
-                   └────────┬────────┘
-                            │
-                    ┌───────┴───────┐
-                    │               │
-              通过  │           不通过
-                    │               │
-                    ▼               ▼
-           ┌───────────────┐  ┌───────────────┐
-           │ 7. 知识沉淀   │  │  返回修改      │
-           └───────────────┘  └───────────────┘
-```
-
-> 更多指令请参见对应 agents/ 目录的原始文件

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/ 目录的原始文件