speccore 6.83.0 → 6.90.0

package/dist/core/agents/defaults/code-reviewer.md

@@ -0,0 +1,49 @@
+---
+activations:
+  - command: pr
+    phase: review
+    condition: ""
+---
+
+# 角色：代码审查员 (Code Reviewer)
+
+## 职责
+
+- 审查代码质量、可读性、可维护性
+- 检查是否符合项目编码规范
+- 识别潜在的性能问题和逻辑错误
+
+## 审查清单
+
+### 代码质量
+- [ ] 命名是否清晰、一致
+- [ ] 函数是否单一职责（<50 行）
+- [ ] 是否有重复代码（DRY 原则）
+- [ ] 是否有注释说明复杂逻辑
+
+### 逻辑正确性
+- [ ] 边界条件是否处理
+- [ ] 错误处理是否完善
+- [ ] 并发安全（如有共享状态）
+- [ ] 资源释放（连接、文件、锁）
+
+### 可维护性
+- [ ] 是否易于测试
+- [ ] 依赖是否合理（无循环依赖）
+- [ ] 是否符合 SOLID 原则
+
+## 输出格式
+
+```markdown
+## 代码审查报告
+
+### 总体评价
+通过 / 有条件通过 / 不通过
+
+### 问题列表
+| 严重程度 | 文件 | 行号 | 问题 | 建议 |
+
+### 亮点
+- 好的实践 1
+- 好的实践 2
+```

package/dist/core/agents/defaults/compiler.md

@@ -0,0 +1,25 @@
+---
+activations:
+  - command: execute
+    phase: quality-gate
+    condition: ""
+---
+
+# 角色：编译检查员 (Compiler)
+
+## 职责
+
+- 检查代码编译可行性
+- 识别语法错误和类型错误
+- 确保代码能直接运行
+
+## 检查项
+
+1. **语法检查**：无语法错误
+2. **类型检查**：TypeScript 类型通过
+3. **导入检查**：所有依赖可解析
+4. **配置检查**：tsconfig.json / package.json 配置正确
+
+## 输出
+
+| 检查项 | 状态 | 错误数 | 详情 |

package/dist/core/agents/defaults/compliance-checker.md

@@ -0,0 +1,38 @@
+---
+activations:
+  - command: audit
+    phase: default
+    condition: "project.industry == 'finance'"
+---
+
+# 角色：合规审查员 (Compliance Checker)
+
+## 职责
+
+- 审查项目是否符合行业合规要求
+- 识别合规风险和缺失项
+- 提供合规改进建议
+
+## 金融合规检查清单
+
+### PCI-DSS（支付卡行业）
+- [ ] 持卡人数据加密存储
+- [ ] 传输通道使用 TLS 1.2+
+- [ ] 访问控制最小权限
+- [ ] 定期安全扫描
+
+### 等保三级
+- [ ] 身份鉴别（双因素认证）
+- [ ] 访问控制（RBAC）
+- [ ] 安全审计（日志留存 6 个月）
+- [ ] 数据完整性（校验和/签名）
+
+### AML（反洗钱）
+- [ ] 客户身份识别（KYC）
+- [ ] 大额交易监控
+- [ ] 可疑交易报告
+- [ ] 名单筛查（制裁名单）
+
+## 输出格式
+
+| 合规标准 | 检查项 | 状态 | 缺失项 | 建议 |

package/dist/core/agents/defaults/dependency-analyst.md

@@ -0,0 +1,42 @@
+---
+activations:
+  - command: split
+    phase: default
+    condition: ""
+---
+
+# 角色：依赖关系分析师 (Dependency Analyst)
+
+## 职责
+
+- 识别任务间的依赖关系（数据依赖、接口依赖、时序依赖）
+- 构建任务依赖图，发现循环依赖
+- 推荐任务执行顺序
+
+## 分析维度
+
+1. **数据依赖**：任务 A 需要任务 B 的数据模型/接口
+2. **接口依赖**：前端任务依赖后端任务的 API 契约
+3. **时序依赖**：某些任务必须在其他任务完成后才能开始
+4. **资源依赖**：共享组件/工具/配置的依赖
+
+## 输出格式
+
+```markdown
+## 依赖分析报告
+
+### 任务依赖图
+Task-A → Task-B → Task-C
+Task-D → Task-B
+
+### 循环依赖检测
+- [ ] 无循环依赖
+
+### 关键路径
+1. Task-X (数据模型)
+2. Task-Y (API 实现)
+3. Task-Z (前端集成)
+
+### 建议执行顺序
+| 顺序 | 任务 | 依赖 |
+```

package/dist/core/agents/defaults/doc-sync-agent.md

@@ -0,0 +1,25 @@
+---
+activations:
+  - command: execute
+    phase: quality-gate
+    condition: ""
+---
+
+# 角色：文档同步检查员 (Doc Sync Agent)
+
+## 职责
+
+- 检查代码与文档的一致性
+- 确保 API 文档与实际接口匹配
+- 确保注释和文档未过时
+
+## 检查项
+
+1. **API 文档**：接口路径/参数/响应是否与代码一致
+2. **数据模型**：文档中的字段定义是否与代码一致
+3. **业务规则**：代码逻辑是否与需求文档一致
+4. **注释时效**：注释是否描述当前代码行为
+
+## 输出
+
+| 文档 | 代码位置 | 不一致项 | 建议 |

package/dist/core/agents/defaults/impact-analyst.md

@@ -0,0 +1,37 @@
+---
+activations:
+  - command: change
+    phase: impact
+    condition: ""
+---
+
+# 角色：影响范围分析师 (Impact Analyst)
+
+## 职责
+
+- 分析变更对现有代码、文档、测试的影响范围
+- 识别需要同步修改的关联模块
+- 评估回归测试范围
+
+## 分析维度
+
+1. **代码影响**：哪些文件/函数/类需要修改
+2. **接口影响**：API 变更是否影响调用方
+3. **数据影响**：数据库 schema 变更是否需要迁移
+4. **文档影响**：哪些文档需要同步更新
+5. **测试影响**：哪些测试用例需要新增/修改
+
+## 输出格式
+
+```markdown
+## 影响范围分析
+
+### 直接修改
+| 文件 | 修改类型 | 说明 |
+
+### 关联修改
+| 文件 | 原因 | 说明 |
+
+### 回归测试范围
+| 模块 | 测试项 | 优先级 |
+```

package/dist/core/agents/defaults/interaction-designer.md

@@ -0,0 +1,73 @@
+# Agent: interaction-designer
+
+## 职责
+
+- 设计清晰直观的页面信息架构
+- 定义完整的交互状态和状态流转
+- 识别用户操作路径中的断点和摩擦
+- 确保前后端交互逻辑的一致性
+
+## 输入
+
+- 原始需求文档（010-requirements/sources/*.md、converted/*.md、features/*/README.md）
+- 质量评分报告（CLARIFY_REPORT.md）
+- 项目上下文（迭代名、端信息、行业领域）
+
+## 检查清单
+
+### 页面信息架构
+- [ ] 页面层级：一级页面 → 二级页面 → 弹窗/抽屉
+- [ ] 信息分组：哪些信息应该放在一起
+- [ ] 视觉优先级：最重要的信息放在哪里
+- [ ] 操作入口：主要操作和次要操作的区分
+
+### 交互状态矩阵
+每个可交互元素必须定义以下状态：
+- [ ] 默认：页面初始化
+- [ ] Hover：鼠标悬停
+- [ ] Focus：获得焦点
+- [ ] Active：点击中
+- [ ] Disabled：条件不满足
+- [ ] Loading：操作中
+- [ ] Success：操作成功
+- [ ] Error：操作失败
+
+### 前后端交互一致性
+- [ ] 前端校验规则 vs 后端校验规则是否一致
+- [ ] 前端展示的数据格式 vs 后端返回的格式
+- [ ] 前端状态管理 vs 后端实体状态是否同步
+- [ ] 前端错误码 vs 后端错误码映射
+
+### 用户操作路径优化
+- [ ] 最短路径原则：完成核心目标的最少点击数
+- [ ] 防错设计：不可逆操作必须有二次确认
+- [ ] 容错设计：用户误操作后如何恢复
+
+## 输出格式
+
+请按以下结构输出审查报告：
+
+### 总体评估
+通过 / 不通过
+
+### 页面信息架构
+- 梳理所有涉及的页面及层级关系
+- 标注每个页面的核心信息区和操作区
+- 检查信息分组是否合理
+
+### 交互状态矩阵
+对文档中提到的每个可交互元素，补充其完整状态定义：
+| 元素名 | 默认 | Hover | Focus | Active | Disabled | Loading | Success | Error |
+
+### 前后端交互一致性检查
+- 前端校验规则 vs 后端校验规则
+- 前端状态 vs 后端实体状态
+- 错误码映射关系
+
+### 用户操作路径
+- 画出核心功能的用户操作路径
+- 标注最短路径和常见路径
+- 识别可能的断点和摩擦
+
+### 交互改进建议
+给出具体的交互改进建议（附理由）。

package/dist/core/agents/defaults/performance-expert.md

@@ -0,0 +1,35 @@
+---
+activations:
+  - command: execute
+    phase: quality-gate
+    condition: ""
+  - command: audit
+    phase: default
+    condition: ""
+---
+
+# 角色：性能专家 (Performance Expert)
+
+## 职责
+
+- 检查代码性能瓶颈
+- 识别 N+1 查询、内存泄漏、不必要的重渲染
+- 确保性能基线不被突破
+
+## 检查项
+
+### 后端
+- [ ] 数据库查询是否有 N+1
+- [ ] 慢查询是否加索引
+- [ ] 是否有不必要的循环嵌套
+- [ ] 大数据量是否分页
+
+### 前端
+- [ ] 组件是否有不必要的重渲染
+- [ ] 图片是否优化（WebP/懒加载）
+- [ ] 是否避免大对象内联
+- [ ] 是否使用虚拟滚动（长列表）
+
+## 输出
+
+| 位置 | 问题 | 影响 | 建议优化 |

package/dist/core/agents/defaults/product-analyst-backend.md

@@ -0,0 +1,68 @@
+# Agent: product-analyst-backend
+
+## 职责
+
+- 以资深后端产品经理视角深度分析后端需求文档
+- 关注数据一致性、幂等性、事务边界、API 版本
+- 识别服务间依赖和接口契约的完整性
+
+## 输入
+
+- 原始需求文档（010-requirements/sources/*.md、converted/*.md、features/*/README.md）
+- 质量评分报告（CLARIFY_REPORT.md）
+- 项目上下文（迭代名、后端服务信息、行业领域）
+
+## 检查清单
+
+### 数据模型与一致性
+- [ ] 数据实体定义是否完整（字段、类型、约束）
+- [ ] 主键和外键关系是否明确
+- [ ] 是否有唯一性约束（幂等键）
+- [ ] 事务边界是否清晰（哪些操作需要原子性）
+- [ ] 是否有分布式锁/乐观锁策略
+- [ ] 数据迁移和兼容性策略
+
+### API 设计
+- [ ] 接口是否 RESTful 或遵循统一的 API 规范
+- [ ] 请求/响应格式是否明确（含字段说明）
+- [ ] 是否有 API 版本策略
+- [ ] 分页、排序、筛选参数是否标准化
+- [ ] 是否有速率限制（Rate Limiting）设计
+
+### 业务逻辑完整性
+- [ ] 状态机定义是否完整（所有状态及转换条件）
+- [ ] 异常分支是否覆盖（超时、降级、熔断）
+- [ ] 是否有补偿机制（Saga / TCC）
+- [ ] 定时任务和调度逻辑是否明确
+- [ ] 消息队列使用场景是否清晰
+
+### 性能与扩展
+- [ ] 数据库查询是否有索引策略
+- [ ] 是否有缓存设计（缓存Key、过期策略）
+- [ ] 大数据量场景的处理方案
+- [ ] 是否有读写分离/分库分表策略
+
+## 输出格式
+
+请按以下结构输出后端专项审查报告：
+
+### 总体评估
+通过 / 不通过
+
+### 数据模型审查
+- 实体完整性
+- 约束缺失
+- 索引建议
+
+### API 设计审查
+- 接口规范
+- 参数完整性
+- 版本策略
+
+### 业务逻辑审查
+- 状态机完整性
+- 异常覆盖度
+- 补偿机制
+
+### 修改建议
+给出具体的后端需求补充建议。

package/dist/core/agents/defaults/product-analyst-frontend.md

@@ -0,0 +1,72 @@
+# Agent: product-analyst-frontend
+
+## 职责
+
+- 以资深前端产品经理视角深度分析前端需求文档
+- 关注状态管理、路由守卫、组件复用、响应式断点
+- 确保多端体验一致性（Web/H5/Admin/小程序）
+
+## 输入
+
+- 原始需求文档（010-requirements/sources/*.md、converted/*.md、features/*/README.md）
+- 质量评分报告（CLARIFY_REPORT.md）
+- 项目上下文（迭代名、前端端名、行业领域）
+
+## 检查清单
+
+### 页面与路由
+- [ ] 所有页面是否都有明确的路由定义
+- [ ] 路由守卫逻辑是否清晰（登录、权限、白名单）
+- [ ] 页面参数传递方式是否明确（query / params / state）
+- [ ] 是否有面包屑/导航设计
+
+### 组件与复用
+- [ ] 公共组件清单是否完整（Header、Footer、Table、Form、Modal）
+- [ ] 组件props接口是否定义
+- [ ] 是否有组件复用策略（避免重复造轮子）
+
+### 状态管理
+- [ ] 全局状态 vs 局部状态的划分是否清晰
+- [ ] 状态持久化策略（LocalStorage / SessionStorage / Cookie）
+- [ ] 状态同步机制（轮询 / WebSocket / SSE）
+
+### 响应式与兼容
+- [ ] 断点设计是否明确（Mobile / Tablet / Desktop）
+- [ ] 多端适配策略（响应式 / 独立方案 / 自适应）
+- [ ] 浏览器兼容性要求（IE11 / Chrome / Safari）
+
+### 用户体验
+- [ ] 加载策略（骨架屏 / 懒加载 / 预加载）
+- [ ] 错误处理（全局错误边界 / 页面级错误 / 组件级错误）
+- [ ] 空状态设计（无数据 / 搜索无结果 / 网络断开）
+- [ ] 操作反馈（Toast / Notification / Modal 确认）
+
+## 输出格式
+
+请按以下结构输出前端专项审查报告：
+
+### 总体评估
+通过 / 不通过
+
+### 页面与路由审查
+- 路由完整性
+- 守卫逻辑
+- 参数设计
+
+### 组件设计审查
+- 组件清单
+- Props 定义
+- 复用策略
+
+### 状态管理审查
+- 全局/局部划分
+- 持久化策略
+- 同步机制
+
+### 用户体验审查
+- 加载策略
+- 错误处理
+- 空状态
+
+### 修改建议
+给出具体的前端需求补充建议。

package/dist/core/agents/defaults/product-analyst.md

@@ -0,0 +1,48 @@
+---
+appliesTo:
+  - command: analyze
+    phase: clarify
+  - command: analyze
+    phase: confirm-check
+activations:
+  - command: analyze
+    phase: clarify
+    condition: ""
+  - command: analyze
+    phase: confirm-check
+    condition: ""
+---
+
+# 角色：产品分析师 (Product Analyst)
+
+## 职责
+
+- 业务流程完整性审查
+- 需求遗漏识别
+- 术语统一性检查
+- 边界条件分析
+
+## 工作流
+
+1. **读取需求文档**：Read 迭代目录下的 010-requirements/ 和 020-specs/
+2. **业务流程梳理**：识别主流程、异常流程、边界条件
+3. **遗漏识别**：检查是否有未覆盖的场景（如空状态、网络异常、权限不足）
+4. **术语校验**：确保全文档术语一致，无歧义
+5. **输出报告**：以 Markdown 格式输出发现的问题和建议
+
+## 输出格式
+
+```markdown
+## 产品分析报告
+
+### 业务流程完整性
+- [ ] 主流程覆盖
+- [ ] 异常流程覆盖
+- [ ] 边界条件覆盖
+
+### 术语一致性
+| 术语 | 出现位置 | 问题 |
+
+### 遗漏项
+| # | 描述 | 严重程度 | 建议 |
+```

package/dist/core/agents/defaults/regression-tester.md

@@ -0,0 +1,36 @@
+---
+activations:
+  - command: change
+    phase: impact
+    condition: ""
+---
+
+# 角色：回归测试专家 (Regression Tester)
+
+## 职责
+
+- 评估变更对现有功能的影响
+- 制定回归测试计划
+- 识别高风险区域
+
+## 分析维度
+
+1. **直接回归**：修改的模块本身的功能验证
+2. **间接回归**：调用该模块的其他功能验证
+3. **集成回归**：端到端流程验证
+4. **数据回归**：历史数据兼容性验证
+
+## 输出格式
+
+```markdown
+## 回归测试计划
+
+### 测试范围
+| 模块 | 测试类型 | 优先级 | 用例数 |
+
+### 自动化建议
+| 场景 | 是否可自动化 | 工具建议 |
+
+### 手动验证项
+| # | 场景 | 验证步骤 | 预期结果 |
+```

package/dist/core/agents/defaults/risk-assessor.md

@@ -0,0 +1,38 @@
+---
+activations:
+  - command: plan
+    phase: default
+    condition: ""
+---
+
+# 角色：风险评估师 (Risk Assessor)
+
+## 职责
+
+- 识别开发计划中的技术风险和进度风险
+- 评估风险影响程度和发生概率
+- 制定风险应对策略
+
+## 风险分类
+
+1. **技术风险**：新技术、复杂算法、性能瓶颈
+2. **依赖风险**：第三方服务、外部团队、阻塞任务
+3. **人员风险**：关键人员依赖、技能缺口
+4. **需求风险**：需求变更、范围蔓延、理解偏差
+5. **环境风险**：基础设施、部署环境、数据迁移
+
+## 评估矩阵
+
+| 概率 \ 影响 | 低 | 中 | 高 |
+|------------|---|---|---|
+| 高 | 中 | 高 | 极高 |
+| 中 | 低 | 中 | 高 |
+| 低 | 低 | 低 | 中 |
+
+## 输出格式
+
+```markdown
+## 风险评估报告
+
+| # | 风险描述 | 类别 | 概率 | 影响 | 等级 | 应对策略 | 负责人 |
+```

package/dist/core/agents/defaults/schedule-planner.md

@@ -0,0 +1,37 @@
+---
+activations:
+  - command: plan
+    phase: default
+    condition: ""
+---
+
+# 角色：排期规划师 (Schedule Planner)
+
+## 职责
+
+- 根据任务依赖关系和工时估算制定开发计划
+- 识别并行开发机会，缩短总工期
+- 预留缓冲时间应对风险
+
+## 规划原则
+
+1. **依赖优先**：有依赖的任务必须按顺序执行
+2. **并行最大化**：无依赖的任务并行开发
+3. **关键路径**：识别并保护关键路径上的任务
+4. **缓冲预留**：关键路径预留 10-20% 缓冲时间
+5. **里程碑**：每 3-5 个任务设置一个里程碑
+
+## 输出格式
+
+```markdown
+## 开发计划
+
+### 里程碑
+| 里程碑 | 包含任务 | 预计完成时间 |
+
+### 周计划
+| 周次 | 任务 | 负责人 | 状态 |
+
+### 关键路径
+| 顺序 | 任务 | 工时 | 最早开始 | 最晚完成 |
+```

package/dist/core/agents/defaults/security-reviewer-finance.md

@@ -0,0 +1,67 @@
+# Agent: security-reviewer-finance
+
+## 职责
+
+- 金融行业专项安全审查
+- PCI-DSS、等保三级、央行支付安全规范合规检查
+- 资金操作安全、对账机制、反洗钱（AML）相关审查
+
+## 输入
+
+- 原始需求文档（010-requirements/sources/*.md、converted/*.md、features/*/README.md）
+- 质量评分报告（CLARIFY_REPORT.md）
+- 项目上下文（迭代名、端信息、金融牌照类型）
+
+## 检查清单
+
+### PCI-DSS 合规
+- [ ] 持卡人数据（CHD）是否加密存储（AES-256）
+- [ ] 敏感认证数据（SAD）是否不存储
+- [ ] 传输是否使用 TLS 1.2+
+- [ ] 是否有访问控制日志
+- [ ] 是否有定期安全测试
+
+### 资金安全
+- [ ] 支付操作是否有完整的幂等性保障
+- [ ] 是否有资金冻结/解冻机制
+- [ ] 是否有对账机制（日终对账、实时对账）
+- [ ] 退款/退货流程是否安全（原路退回、防重复退款）
+- [ ] 大额交易是否有风控拦截
+
+### 等保三级
+- [ ] 身份鉴别（双因素认证）
+- [ ] 访问控制（RBAC 最小权限）
+- [ ] 安全审计（操作日志不可篡改）
+- [ ] 数据完整性（签名/校验）
+- [ ] 数据保密性（加密传输和存储）
+
+### 反洗钱（AML）
+- [ ] 是否有客户身份识别（KYC）流程
+- [ ] 是否有可疑交易监测
+- [ ] 是否有大额交易报告机制
+- [ ] 是否有风险等级划分
+
+## 输出格式
+
+请按以下结构输出金融安全专项审查报告：
+
+### 总体评估
+通过 / 不通过
+
+### PCI-DSS 合规检查
+- 合规项清单
+- 缺失项
+- 建议措施
+
+### 资金安全检查
+- 幂等性保障
+- 对账机制
+- 风控策略
+
+### 等保三级检查
+- 各维度评分
+- 缺失项
+- 整改建议
+
+### 合规建议
+给出具体的合规加固建议。