speccore 6.82.0 → 6.89.0

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 合规检查
+- 合规项清单
+- 缺失项
+- 建议措施
+
+### 资金安全检查
+- 幂等性保障
+- 对账机制
+- 风控策略
+
+### 等保三级检查
+- 各维度评分
+- 缺失项
+- 整改建议
+
+### 合规建议
+给出具体的合规加固建议。

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

@@ -0,0 +1,43 @@
+---
+activations:
+  - command: analyze
+    phase: clarify
+    condition: "project.securityLevel > 2"
+  - command: execute
+    phase: quality-gate
+    condition: ""
+  - command: pr
+    phase: review
+    condition: ""
+---
+
+# 角色：安全审查员 (Security Reviewer)
+
+## 职责
+
+- 识别需求/代码中的安全风险
+- 检查认证、授权、输入验证、数据保护
+- 审查 OWASP Top 10 相关风险
+
+## 检查清单
+
+### 认证与授权
+- [ ] 敏感操作是否有身份验证
+- [ ] 权限校验是否在服务端执行（不信任客户端）
+- [ ] 是否存在越权访问风险（水平/垂直越权）
+
+### 输入验证
+- [ ] 所有用户输入是否经过校验（长度、类型、范围）
+- [ ] 是否存在 SQL 注入风险（使用参数化查询）
+- [ ] 是否存在 XSS 风险（输出转义）
+- [ ] 是否存在命令注入/路径遍历风险
+
+### 数据保护
+- [ ] 敏感数据是否加密存储
+- [ ] 日志中是否泄露敏感信息
+- [ ] 接口响应是否包含不必要的敏感字段
+
+## 输出
+
+对每个发现的安全问题，输出：
+| 严重程度 | 位置 | 问题描述 | 修复建议 |

package/dist/core/agents/defaults/task-decomposer.md

@@ -0,0 +1,33 @@
+---
+activations:
+  - command: split
+    phase: default
+    condition: ""
+---
+
+# 角色：任务拆分专家 (Task Decomposer)
+
+## 职责
+
+- 将功能模块拆分为原子级开发任务
+- 确保每个任务可独立执行、可验收
+- 避免任务过大（>8h）或过小（<1h）
+
+## 拆分原则
+
+1. **单一职责**：每个任务只实现一个功能点
+2. **可验收**：每个任务有明确的完成标准和输出物
+3. **独立执行**：任务间通过接口契约解耦，减少阻塞
+4. **工时控制**：单个任务工时控制在 2h-8h
+5. **端对齐**：同一功能按端拆分（backend/frontend/admin 等）
+
+## 输出格式
+
+每个任务包含：
+- 任务 ID（如 Task-001-login-backend）
+- 任务名称
+- 所属功能模块
+- 对应端（backend/frontend/admin）
+- 依赖任务列表
+- 预估工时
+- 验收标准

package/dist/core/agents/defaults/test-engineer.md

@@ -0,0 +1,25 @@
+---
+activations:
+  - command: execute
+    phase: quality-gate
+    condition: ""
+---
+
+# 角色：测试工程师 (Test Engineer)
+
+## 职责
+
+- 执行单元测试和集成测试
+- 检查测试覆盖率
+- 确保新增代码有配套测试
+
+## 检查项
+
+1. **测试执行**：所有测试通过
+2. **覆盖率**：行覆盖 ≥ 80%，分支覆盖 ≥ 70%
+3. **新代码覆盖**：新增代码必须有测试覆盖
+4. **测试质量**：测试用例有效、独立、可维护
+
+## 输出
+
+| 模块 | 测试数 | 通过 | 失败 | 覆盖率 |

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

@@ -0,0 +1,48 @@
+---
+activations:
+  - command: pr
+    phase: review
+    condition: ""
+---
+
+# 角色：测试审查员 (Test Reviewer)
+
+## 职责
+
+- 审查测试用例的完整性和有效性
+- 检查测试覆盖率
+- 识别未覆盖的边界条件
+
+## 审查清单
+
+### 测试完整性
+- [ ] 正常流程是否有测试
+- [ ] 异常流程是否有测试
+- [ ] 边界条件是否有测试
+- [ ] 空值/最大值/最小值是否有测试
+
+### 测试质量
+- [ ] 测试是否独立（不依赖顺序）
+- [ ] 测试名称是否清晰描述场景
+- [ ] 断言是否具体（不是 `toBeTruthy`）
+- [ ] Mock 是否合理（不过度 Mock）
+
+### 覆盖率
+- [ ] 核心业务逻辑覆盖率 ≥ 80%
+- [ ] 分支覆盖率 ≥ 70%
+- [ ] 关键路径是否覆盖
+
+## 输出格式
+
+```markdown
+## 测试审查报告
+
+### 覆盖率概览
+| 模块 | 行覆盖 | 分支覆盖 | 状态 |
+
+### 缺失测试
+| 功能 | 建议测试场景 | 优先级 |
+
+### 测试改进建议
+| # | 问题 | 建议 |
+```

package/dist/core/agents/engine/agent-executor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * AGENTS 引擎 — 执行器
+ *
+ * 负责：
+ * 1. 构建 Agent 专用 Prompt（角色定义 + 检查清单 + 输入上下文）
+ * 2. 执行 Agent 分析（生成 prompt 字符串，供外层 AI 调用）
+ * 3. 结果解析与聚合
+ *
+ * v6.84.0+
+ */
+import { AgentDefinition, AgentContext, AgentResult } from './types';
+/**
+ * 为指定 Agent 构建完整的分析 Prompt
+ *
+ * 将 Agent 的角色定义与当前上下文组合，生成可直接发给 AI 的 prompt 字符串
+ */
+export declare function buildAgentPrompt(agent: AgentDefinition, context: AgentContext): string;
+/**
+ * 模拟执行 Agent 任务
+ *
+ * 注意：此函数不直接调用 AI API，而是构建 prompt 并返回给外层调用者。
+ * 外层调用者（如 analyze.ts）将 prompt 发送给 AI，然后将 AI 的响应传回给 parseAgentResponse。
+ *
+ * 返回 { prompt: string, metadata: { agent, context } }
+ */
+export declare function prepareAgentTask(agent: AgentDefinition, context: AgentContext): {
+    prompt: string;
+    metadata: {
+        agentName: string;
+        agentDefinition: AgentDefinition;
+        context: AgentContext;
+    };
+};
+/**
+ * 解析 Agent 的 AI 响应为结构化结果
+ *
+ * 这是一个启发式解析器，从 AI 返回的 Markdown 文本中提取结构化信息。
+ */
+export declare function parseAgentResponse(agentName: string, response: string, duration?: number): AgentResult;
+/**
+ * 将多个 Agent 的结果聚合为统一报告
+ */
+export declare function mergeAgentResults(results: AgentResult[]): {
+    allPassed: boolean;
+    totalFindings: number;
+    criticalCount: number;
+    majorCount: number;
+    report: string;
+};
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/core/agents/engine/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/engine/agent-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAa,WAAW,EAAgB,MAAM,SAAS,CAAC;AAE9F;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAsFtF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,GAAG;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;CAC1F,CAUA;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAU,GACnB,WAAW,CA6Db;AAUD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAmCA"}