sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/sinapse-workflows/brownfield-discovery-workflow.md

@@ -1,915 +0,0 @@
-# 工作流：棕地项目发现
-
-**ID：** `brownfield-discovery`
-**版本：** 2.0
-**类型：** 棕地项目（现有项目）
-**估计时长：** 4-8小时
-**最后更新：** 2026-02-04
-
----
-
-## 概述
-
-**棕地项目发现**是一个完整的多代理工作流，用于评估现有项目中的技术债务。专门为从Lovable、v0.dev或遗留代码库迁移的项目设计，该工作流：
-
-- 全面记录系统
-- 识别所有层（系统、数据库、前端）的技术债务
-- 通过领域专家验证发现
-- 为利益相关者生成执行报告
-- 创建准备好开发的史诗和故事
-
-### 主要用例
-
-| 场景 | 推荐 |
-|------|------|
-| Lovable/v0.dev项目迁移 | 是 |
-| 完整代码库审计 | 是 |
-| 现代化规划 | 是 |
-| 投资前评估 | 是 |
-| 遗留项目入职 | 是 |
-| 技术尽职调查 | 是 |
-| 新项目（绿地项目） | 否 - 使用 `greenfield-*` 工作流 |
-| 隔离增强 | 否 - 使用 `brownfield-create-story` |
-
----
-
-## 工作流图
-
-```mermaid
-flowchart TD
-    subgraph FASE_1_3["阶段1-3：数据收集"]
-        A[("启动：棕地项目发现")] --> B["@architect<br/>系统文档"]
-        B --> C{项目有<br/>数据库?}
-        C -->|是| D["@data-engineer<br/>Schema + 审计"]
-        C -->|否| E["@ux-design-expert<br/>前端规范"]
-        D --> E
-    end
-
-    subgraph FASE_4["阶段4：初步整合"]
-        E --> F["@architect<br/>整合DRAFT"]
-    end
-
-    subgraph FASE_5_7["阶段5-7：专家验证"]
-        F --> G["@data-engineer<br/>验证DB部分"]
-        G --> H["@ux-design-expert<br/>验证UX部分"]
-        H --> I["@qa<br/>质量关卡审查"]
-        I --> J{QA关卡?}
-        J -->|需要修复| K["返工：<br/>应用修正到DRAFT"]
-        K --> F
-    end
-
-    subgraph FASE_8_9["阶段8-9：最终报告"]
-        J -->|已批准| L["@architect<br/>最终评估"]
-        L --> M["@analyst<br/>执行报告"]
-    end
-
-    subgraph FASE_10["阶段10：规划"]
-        M --> N["@pm<br/>创建史诗"]
-        N --> O["@pm<br/>创建故事"]
-        O --> P(["发现完成"])
-    end
-
-    style A fill:#E8F5E9,stroke:#4CAF50,stroke-width:2px
-    style P fill:#90EE90,stroke:#2E7D32,stroke-width:3px
-    style B fill:#FFE4B5,stroke:#F57C00
-    style D fill:#FFE4B5,stroke:#F57C00
-    style E fill:#FFE4B5,stroke:#F57C00
-    style F fill:#ADD8E6,stroke:#1976D2
-    style L fill:#ADD8E6,stroke:#1976D2
-    style G fill:#F0E68C,stroke:#FBC02D
-    style H fill:#F0E68C,stroke:#FBC02D
-    style I fill:#F0E68C,stroke:#FBC02D
-    style M fill:#DDA0DD,stroke:#7B1FA2
-    style N fill:#DDA0DD,stroke:#7B1FA2
-    style O fill:#DDA0DD,stroke:#7B1FA2
-    style J fill:#FFCDD2,stroke:#D32F2F,stroke-width:2px
-```
-
----
-
-## 详细序列图
-
-```mermaid
-sequenceDiagram
-    autonumber
-    participant U as 用户
-    participant AR as @architect<br/>Aria
-    participant DE as @data-engineer<br/>Dara
-    participant UX as @ux-design-expert<br/>Uma
-    participant QA as @qa<br/>Quinn
-    participant AN as @analyst<br/>Atlas
-    participant PM as @pm<br/>Morgan
-
-    rect rgb(255, 248, 220)
-        Note over AR,UX: 阶段1-3：数据收集（可并行化）
-        U->>AR: 启动棕地项目发现
-        AR->>AR: *document-project
-        AR-->>U: docs/architecture/system-architecture.md
-
-        alt 项目有数据库
-            U->>DE: 审计数据库
-            DE->>DE: *db-schema-audit + *security-audit
-            DE-->>U: supabase/docs/SCHEMA.md + DB-AUDIT.md
-        end
-
-        U->>UX: 记录前端
-        UX->>UX: *create-front-end-spec
-        UX-->>U: docs/frontend/frontend-spec.md
-    end
-
-    rect rgb(173, 216, 230)
-        Note over AR: 阶段4：初步整合
-        U->>AR: 整合所有发现
-        AR->>AR: 阅读所有文档
-        AR-->>U: docs/prd/technical-debt-DRAFT.md
-    end
-
-    rect rgb(240, 230, 140)
-        Note over DE,QA: 阶段5-7：专家验证
-        U->>DE: 审查数据库部分
-        DE->>DE: 验证 + 估算 + 优先级排序
-        DE-->>U: docs/reviews/db-specialist-review.md
-
-        U->>UX: 审查UX/前端部分
-        UX->>UX: 验证 + 估算 + 优先级排序
-        UX-->>U: docs/reviews/ux-specialist-review.md
-
-        U->>QA: 质量关卡审查
-        QA->>QA: 检查缺口 + 风险 + 依赖关系
-
-        alt QA关卡已批准
-            QA-->>U: docs/reviews/qa-review.md (已批准)
-        else QA关卡需要修复
-            QA-->>U: docs/reviews/qa-review.md (需要修复)
-            Note over AR: 返回阶段4
-        end
-    end
-
-    rect rgb(221, 160, 221)
-        Note over AR,PM: 阶段8-10：完成
-        U->>AR: 创建最终评估
-        AR->>AR: 整合所有审查
-        AR-->>U: docs/prd/technical-debt-assessment.md
-
-        U->>AN: 创建执行报告
-        AN->>AN: 计算成本 + ROI
-        AN-->>U: docs/reports/TECHNICAL-DEBT-REPORT.md
-
-        U->>PM: 创建史诗和故事
-        PM->>PM: *brownfield-create-epic
-        PM->>PM: *brownfield-create-story (重复)
-        PM-->>U: docs/stories/epic-technical-debt.md + 故事
-    end
-
-    Note over U,PM: 发现完成！
-```
-
----
-
-## 详细步骤
-
-### 阶段1：收集 - 系统
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `system_documentation` |
-| **阶段** | 1 |
-| **阶段名称** | 收集：系统 |
-| **代理** | `@architect` (Aria) |
-| **操作** | `*document-project` |
-| **需要询问** | 是 |
-| **估计时长** | 30-60分钟 |
-| **输出** | `docs/architecture/system-architecture.md` |
-
-**代理分析的内容：**
-- 技术栈（React、Vite、Tailwind等）
-- 文件夹结构和组件
-- 依赖关系和版本
-- 现有代码模式
-- 集成点
-- 配置（env、build、deploy）
-
-**识别的债务（系统级别）：**
-- 过时的依赖关系
-- 代码重复
-- 缺少测试
-- 硬编码配置
-- 过度耦合
-
----
-
-### 阶段2：收集 - 数据库
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `database_documentation` |
-| **阶段** | 2 |
-| **阶段名称** | 收集：数据库 |
-| **代理** | `@data-engineer` (Dara - Sage) |
-| **操作** | `*db-schema-audit` + `*security-audit` |
-| **条件** | `project_has_database` |
-| **需要询问** | 是 |
-| **估计时长** | 20-40分钟 |
-| **输出** | `supabase/docs/SCHEMA.md`、`supabase/docs/DB-AUDIT.md` |
-
-**代理分析的内容：**
-- 完整schema（表、列、类型）
-- 关系和外键
-- 现有和缺失的索引
-- RLS策略（覆盖和质量）
-- 视图和函数
-- 性能（已知的慢查询）
-
-**识别的债务（数据级别）：**
-- 无RLS的表
-- 缺失的索引
-- 不当的规范化
-- 缺少约束
-- 未版本化的迁移
-- 孤立数据
-
----
-
-### 阶段3：收集 - 前端/UX
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `frontend_documentation` |
-| **阶段** | 3 |
-| **阶段名称** | 收集：前端/UX |
-| **代理** | `@ux-design-expert` (Uma - Empathizer) |
-| **操作** | `*create-front-end-spec` |
-| **需要询问** | 是 |
-| **估计时长** | 30-45分钟 |
-| **输出** | `docs/frontend/frontend-spec.md` |
-
-**代理分析的内容：**
-- 现有UI组件
-- 使用的设计系统/令牌
-- 布局模式
-- 用户流程
-- 响应性
-- 可访问性（a11y）
-- 视觉一致性
-- 感知性能
-
-**识别的债务（UX/UI级别）：**
-- 视觉不一致
-- 重复的组件
-- 缺少设计系统
-- 可访问性问题
-- 移动端未优化
-- 缺少加载/错误状态
-- 缺少用户反馈
-
----
-
-### 阶段4：初步整合
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `initial_consolidation` |
-| **阶段** | 4 |
-| **阶段名称** | 初步整合 |
-| **代理** | `@architect` (Aria) |
-| **操作** | `consolidate_findings_draft` (工作流-操作) |
-| **需要询问** | 是 |
-| **估计时长** | 30-45分钟 |
-| **输出** | `docs/prd/technical-debt-DRAFT.md` |
-
-**要求作为输入：**
-- `docs/architecture/system-architecture.md`
-- `supabase/docs/SCHEMA.md` (如果存在)
-- `supabase/docs/DB-AUDIT.md` (如果存在)
-- `docs/frontend/frontend-spec.md`
-
-**生成的DRAFT结构：**
-
-```markdown
-# 技术债务评估 - DRAFT
-## 专家审查待处理
-
-### 1. 系统债务
-[来自system-architecture.md的列表]
-
-### 2. 数据库债务
-[来自DB-AUDIT.md的列表]
-待处理：@data-engineer的审查
-
-### 3. 前端/UX债务
-[来自frontend-spec.md的列表]
-待处理：@ux-design-expert的审查
-
-### 4. 初步矩阵
-| ID | 债务 | 区域 | 影响 | 工作量 | 优先级 |
-|----|------|------|------|--------|--------|
-
-### 5. 专家问题
-- @data-engineer：[关于数据库的问题]
-- @ux-design-expert：[关于UX的问题]
-```
-
----
-
-### 阶段5：验证 - 数据库
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `database_specialist_review` |
-| **阶段** | 5 |
-| **阶段名称** | 验证：数据库 |
-| **代理** | `@data-engineer` (Dara) |
-| **操作** | `review_and_validate` (工作流-操作) |
-| **需要询问** | 是 |
-| **估计时长** | 20-30分钟 |
-| **输出** | `docs/reviews/db-specialist-review.md` |
-
-**专家的职责：**
-
-1. **验证识别的债务**
-   - 确认是否真的是问题
-   - 调整严重性（如需要）
-   - 添加未识别的债务
-
-2. **估算成本**
-   - 解决每个债务的小时数
-   - 复杂性（简单/中等/复杂）
-   - 技术依赖关系
-
-3. **优先级排序（DB视角）**
-   - 安全风险
-   - 性能影响
-   - 维护负债
-
-4. **回答问题**
-   - 回答@architect的问题
-   - 澄清技术要点
-
----
-
-### 阶段6：验证 - UX/前端
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `ux_specialist_review` |
-| **阶段** | 6 |
-| **阶段名称** | 验证：UX/前端 |
-| **代理** | `@ux-design-expert` (Uma) |
-| **操作** | `review_and_validate` (工作流-操作) |
-| **需要询问** | 是 |
-| **估计时长** | 20-30分钟 |
-| **输出** | `docs/reviews/ux-specialist-review.md` |
-
-**专家的职责：**
-
-1. **验证识别的债务**
-   - 确认是否影响UX
-   - 调整严重性（如需要）
-   - 添加未识别的债务
-
-2. **估算成本**
-   - 解决每个债务的小时数
-   - 视觉对比功能影响
-   - 需要设计审查
-
-3. **优先级排序（UX视角）**
-   - 用户体验影响
-   - 可访问性问题
-   - 视觉一致性
-
-4. **回答问题**
-   - 回答@architect的问题
-   - 建议设计解决方案
-
----
-
-### 阶段7：验证 - QA审查
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `qa_general_review` |
-| **阶段** | 7 |
-| **阶段名称** | 验证：QA审查 |
-| **代理** | `@qa` (Quinn - Guardian) |
-| **操作** | `review_assessment` (工作流-操作) |
-| **需要询问** | 是 |
-| **估计时长** | 30-45分钟 |
-| **输出** | `docs/reviews/qa-review.md` |
-
-**QA的职责：**
-
-1. **识别缺口**
-   - 未覆盖的债务
-   - 未分析的区域
-   - 跨域风险
-
-2. **评估风险**
-   - 安全风险
-   - 回归风险
-   - 集成风险
-
-3. **验证依赖关系**
-   - 解决顺序是否有意义？
-   - 债务之间的依赖关系
-   - 潜在的阻碍
-
-4. **建议测试**
-   - 解决后所需的测试
-   - 债务的验收标准
-   - 质量指标
-
-5. **质量关卡**
-   - 评估是否完整？
-   - 是否可以继续规划？
-   - **决策：** `已批准` | `需要修复`
-
----
-
-### 阶段8：最终评估
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `final_assessment` |
-| **阶段** | 8 |
-| **阶段名称** | 最终评估 |
-| **代理** | `@architect` (Aria) |
-| **操作** | `finalize_assessment` (工作流-操作) |
-| **条件** | `qa_review_approved` |
-| **需要询问** | 是 |
-| **估计时长** | 30-45分钟 |
-| **输出** | `docs/prd/technical-debt-assessment.md` |
-
-**最终整合包括：**
-1. 整合@data-engineer的调整
-2. 整合@ux-design-expert的调整
-3. 处理@qa的缺口
-4. 使用专家的输入重新计算优先级
-5. 定义最终解决顺序
-
-**最终文档的结构：**
-
-```markdown
-# 技术债务评估 - 最终
-
-## 执行摘要
-- 总债务数：X
-- 关键：Y | 高：Z | 中等：W
-- 估计总工作量：XXX小时
-
-## 完整债务清单
-
-### 系统（由@architect验证）
-| ID | 债务 | 严重性 | 小时 | 优先级 |
-
-### 数据库（由@data-engineer验证）
-| ID | 债务 | 严重性 | 小时 | 优先级 |
-
-### 前端/UX（由@ux-design-expert验证）
-| ID | 债务 | 严重性 | 小时 | 优先级 |
-
-## 最终优先级矩阵
-
-## 解决计划
-
-## 风险和缓解
-
-## 成功标准
-```
-
----
-
-### 阶段9：执行报告
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `executive_awareness_report` |
-| **阶段** | 9 |
-| **阶段名称** | 执行报告 |
-| **代理** | `@analyst` (Atlas - Decoder) |
-| **操作** | `create_awareness_report` (工作流-操作) |
-| **需要询问** | 是 |
-| **估计时长** | 30-45分钟 |
-| **输出** | `docs/reports/TECHNICAL-DEBT-REPORT.md` |
-
-**目的：** 为利益相关者理解所识别技术债务的成本和影响的文档。
-
-**报告结构：**
-
-```markdown
-# 技术债务报告
-**项目：** [名称]
-**日期：** [日期]
-
-## 执行摘要（1页）
-### 当前状况
-### 关键数字
-| 指标 | 值 |
-|------|-----|
-| 总债务数 | X |
-| 关键债务 | Y |
-| 总工作量 | Z小时 |
-| 估计成本 | 人民币XX,XXX |
-
-## 成本分析
-### 解决的成本
-### 不解决的成本（累积风险）
-
-## 业务影响
-### 性能
-### 安全
-### 用户体验
-### 可维护性
-
-## 推荐时间表
-### 阶段1：快速胜利（1-2周）
-### 阶段2：基础（2-4周）
-### 阶段3：优化（4-6周）
-
-## 解决的ROI
-
-## 后续步骤
-```
-
----
-
-### 阶段10：规划（史诗+故事）
-
-| 属性 | 值 |
-|------|-----|
-| **步骤ID** | `epic_creation` + `story_creation` |
-| **阶段** | 10 |
-| **阶段名称** | 规划 |
-| **代理** | `@pm` (Morgan - Strategist) |
-| **操作** | `*brownfield-create-epic`、`*brownfield-create-story` |
-| **需要询问** | 是 |
-| **估计时长** | 30-60分钟 |
-| **输出** | `docs/stories/epic-technical-debt.md`、`docs/stories/story-*.md` |
-
-**史诗包括：**
-- 史诗的目标
-- 范围（哪些债务）
-- 成功标准
-- 时间表（来自报告）
-- 批准的预算
-- 故事列表
-
-**每个故事包括：**
-- 清晰的任务
-- 具体的验收标准
-- 所需的测试（来自QA审查）
-- 由专家验证的估算
-- 完成定义
-
----
-
-## 参与的代理
-
-```mermaid
-mindmap
-  root((棕地项目<br/>发现))
-    收集
-      architect["@architect<br/>Aria (愿景家)<br/>系统和整合"]
-      data-engineer["@data-engineer<br/>Dara (智者)<br/>数据库"]
-      ux-design-expert["@ux-design-expert<br/>Uma (同情者)<br/>前端/UX"]
-    验证
-      data-engineer2["@data-engineer<br/>审查DB"]
-      ux-design-expert2["@ux-design-expert<br/>审查UX"]
-      qa["@qa<br/>Quinn (守护者)<br/>质量关卡"]
-    完成
-      architect2["@architect<br/>最终评估"]
-      analyst["@analyst<br/>Atlas (解码器)<br/>执行报告"]
-      pm["@pm<br/>Morgan (战略家)<br/>史诗和故事"]
-```
-
-### 代理配置
-
-| 代理 | ID | 原型 | 主要专长 |
-|------|-----|------|---------|
-| Aria | `@architect` | 愿景家 | 系统架构、整体设计 |
-| Dara | `@data-engineer` | 智者 | PostgreSQL、Supabase、RLS、迁移 |
-| Uma | `@ux-design-expert` | 同情者 | 原子设计、设计令牌、可访问性 |
-| Quinn | `@qa` | 守护者 | 质量关卡、测试、可追溯性 |
-| Atlas | `@analyst` | 解码器 | 研究、分析、ROI |
-| Morgan | `@pm` | 战略家 | PRD、史诗、优先级 |
-
----
-
-## 执行的任务
-
-### 自动化任务（任务参考）
-
-| 任务 | 代理 | 阶段 | 描述 |
-|------|------|------|------|
-| `document-project` | @architect | 1 | 系统完整文档 |
-| `db-schema-audit` | @data-engineer | 2 | 数据库schema审计 |
-| `security-audit` | @data-engineer | 2 | 安全审计（RLS、PII） |
-| `create-front-end-spec` | @ux-design-expert | 3 | 前端规范 |
-| `brownfield-create-epic` | @pm | 10 | 技术债务史诗创建 |
-| `brownfield-create-story` | @pm | 10 | 故事创建（可重复） |
-
-### 手动操作（工作流-操作）
-
-| 操作 | 代理 | 阶段 | 描述 |
-|------|------|------|------|
-| `consolidate_findings_draft` | @architect | 4 | 整合DRAFT初稿 |
-| `review_and_validate` | @data-engineer | 5 | 验证数据库债务 |
-| `review_and_validate` | @ux-design-expert | 6 | 验证UX债务 |
-| `review_assessment` | @qa | 7 | 质量关卡审查 |
-| `finalize_assessment` | @architect | 8 | 最终评估 |
-| `create_awareness_report` | @analyst | 9 | 执行报告 |
-
----
-
-## 前置条件
-
-### 环境
-
-- [ ] 访问项目存储库
-- [ ] 已安装Supabase CLI（如有数据库）
-- [ ] 数据库凭证可用
-- [ ] 对所有文件的读取权限
-
-### 先前的文档
-
-- [ ] 对项目目的的基本理解
-- [ ] 知道报告的利益相关者
-
-### 使用的工具
-
-| 工具 | 代理 | 目的 |
-|------|------|------|
-| `git` | @architect | 存储库分析 |
-| `supabase-cli` | @data-engineer | 数据库审计 |
-| `psql` | @data-engineer | 审计查询 |
-| `coderabbit` | @qa | 自动代码审查 |
-| `exa` | @analyst | 市场研究/基准 |
-
----
-
-## 输入和输出
-
-### 工件映射
-
-```mermaid
-flowchart LR
-    subgraph 输入
-        E1[源代码]
-        E2[数据库Schema]
-        E3[UI/组件]
-        E4[配置]
-    end
-
-    subgraph 阶段1_3[阶段1-3]
-        A1[system-architecture.md]
-        A2[SCHEMA.md]
-        A3[DB-AUDIT.md]
-        A4[frontend-spec.md]
-    end
-
-    subgraph 阶段4[阶段4]
-        B1[technical-debt-DRAFT.md]
-    end
-
-    subgraph 阶段5_7[阶段5-7]
-        C1[db-specialist-review.md]
-        C2[ux-specialist-review.md]
-        C3[qa-review.md]
-    end
-
-    subgraph 阶段8_10[阶段8-10]
-        D1[technical-debt-assessment.md]
-        D2[TECHNICAL-DEBT-REPORT.md]
-        D3[epic-technical-debt.md]
-        D4[story-*.md]
-    end
-
-    E1 --> A1
-    E2 --> A2
-    E2 --> A3
-    E3 --> A4
-    E4 --> A1
-
-    A1 --> B1
-    A2 --> B1
-    A3 --> B1
-    A4 --> B1
-
-    B1 --> C1
-    B1 --> C2
-    C1 --> C3
-    C2 --> C3
-
-    C1 --> D1
-    C2 --> D1
-    C3 --> D1
-
-    D1 --> D2
-    D2 --> D3
-    D3 --> D4
-```
-
-### 最终工件结构
-
-```text
-docs/
-├── architecture/
-│   └── system-architecture.md         [阶段1]
-├── frontend/
-│   └── frontend-spec.md               [阶段3]
-├── reviews/
-│   ├── db-specialist-review.md        [阶段5]
-│   ├── ux-specialist-review.md        [阶段6]
-│   └── qa-review.md                   [阶段7]
-├── prd/
-│   ├── technical-debt-DRAFT.md        [阶段4]
-│   └── technical-debt-assessment.md   [阶段8]
-├── reports/
-│   └── TECHNICAL-DEBT-REPORT.md       [阶段9] ← 利益相关者
-└── stories/
-    ├── epic-technical-debt.md         [阶段10]
-    ├── story-1.1-*.md
-    └── story-1.2-*.md
-
-supabase/
-└── docs/
-    ├── SCHEMA.md                      [阶段2]
-    └── DB-AUDIT.md                    [阶段2]
-```
-
----
-
-## 决策点
-
-### 决策点1：项目有数据库?
-
-```mermaid
-flowchart TD
-    Q1{项目有<br/>数据库?}
-    Q1 -->|是| A1[执行阶段2：<br/>@data-engineer审计DB]
-    Q1 -->|否| A2[跳过阶段2：<br/>直接到阶段3]
-    A1 --> B[阶段3：前端]
-    A2 --> B
-```
-
-**标准：**
-- 存在 `supabase/` 文件夹或类似？
-- 有迁移文件？
-- 项目使用Supabase、PostgreSQL或其他DB？
-
----
-
-### 决策点2：QA关卡
-
-```mermaid
-flowchart TD
-    Q2{QA关卡状态?}
-    Q2 -->|已批准| A3[继续阶段8：<br/>最终评估]
-    Q2 -->|需要修复| A4[返回阶段4：<br/>返工DRAFT]
-    A4 --> A5[整合QA反馈]
-    A5 --> A6[重新提交验证]
-    A6 --> Q2
-```
-
-**批准标准：**
-- 所有债务由专家验证
-- 无未识别的关键缺口
-- 依赖关系有意义
-- 风险已映射
-
-**需要修复标准：**
-- 未处理的缺口
-- 债务缺少验证
-- 未缓解的跨域风险
-- 不一致的依赖关系
-
----
-
-### 决策点3：范围增长
-
-```mermaid
-flowchart TD
-    Q3{史诗范围}
-    Q3 -->|1-3个故事| A7[使用brownfield-create-epic<br/>简单工作流]
-    Q3 -->|4+个故事| A8[考虑完整PRD<br/>扩展工作流]
-    Q3 -->|新架构| A9[使用greenfield工作流]
-```
-
----
-
-## 故障排除
-
-### 问题：阶段2由于缺少DB访问权限而失败
-
-**症状：** `psql：连接被拒绝` 或凭证无效
-
-**解决方案：**
-1. 检查环境中的 `SUPABASE_DB_URL`
-2. 手动测试连接：`psql "$SUPABASE_DB_URL" -c "SELECT 1"`
-3. 确认网络权限（VPN、防火墙）
-4. 如果无法访问，跳过阶段2并记录为债务
-
----
-
-### 问题：评估太大
-
-**症状：** DRAFT中识别了超过50个债务
-
-**解决方案：**
-1. 按严重性优先级债务（关键>高>中等）
-2. 将类似债务分组到类别中
-3. 考虑按区域的多个史诗（DB、前端、基础设施）
-4. 关注前10-15个债务的第一个周期
-
----
-
-### 问题：专家意见不同
-
-**症状：** @data-engineer和@ux-design-expert优先级冲突
-
-**解决方案：**
-1. @architect作为调解人
-2. 使用客观优先级框架（RICE、ICE）
-3. 考虑跨域影响（慢DB影响UX）
-4. 在最终评估中记录权衡
-
----
-
-### 问题：QA关卡无限循环
-
-**症状：** 多次需要修复
-
-**解决方案：**
-1. 与@qa审查批准标准
-2. 关注特定缺口（不是所有）
-3. 考虑在条件下批准
-4. 如果被阻止，升级到利益相关者
-
----
-
-### 问题：执行报告与利益相关者不共鸣
-
-**症状：** 反馈报告太技术性
-
-**解决方案：**
-1. 使用业务语言，而不是技术
-2. 关注人民币成本（而不是小时数）
-3. 包括类比和比较
-4. 添加影响的视觉图表
-
----
-
-## 参考
-
-### 工作流文件
-
-| 文件 | 位置 |
-|------|------|
-| 工作流定义 | `.sinapse-ai/development/workflows/brownfield-discovery.yaml` |
-| 任务：brownfield-create-epic | `.sinapse-ai/development/tasks/brownfield-create-epic.md` |
-| 任务：brownfield-create-story | `.sinapse-ai/development/tasks/brownfield-create-story.md` |
-| 任务：db-schema-audit | `.sinapse-ai/development/tasks/db-schema-audit.md` |
-| 任务：security-audit | `.sinapse-ai/development/tasks/security-audit.md` |
-
-### 代理
-
-| 代理 | 位置 |
-|------|------|
-| @architect | `.sinapse-ai/development/agents/architect.md` |
-| @data-engineer | `.sinapse-ai/development/agents/data-engineer.md` |
-| @ux-design-expert | `.sinapse-ai/development/agents/ux-design-expert.md` |
-| @qa | `.sinapse-ai/development/agents/qa.md` |
-| @analyst | `.sinapse-ai/development/agents/analyst.md` |
-| @pm | `.sinapse-ai/development/agents/pm.md` |
-
----
-
-## 时间估计
-
-| 复杂度 | 最小时间 | 典型时间 | 最大时间 |
-|--------|---------|---------|---------|
-| 简单项目（无DB） | 3小时 | 4小时 | 5小时 |
-| 中等项目 | 4小时 | 5-6小时 | 7小时 |
-| 复杂项目 | 6小时 | 7-8小时 | 10+小时 |
-
-**增加时间的因素：**
-- 大数据库，有许多表
-- 具有许多组件的前端
-- 多个外部集成
-- QA关卡的返工
-- 利益相关者有许多问题
-
----
-
-## 发现后的后续步骤
-
-1. **呈现** `TECHNICAL-DEBT-REPORT.md` 给利益相关者
-2. **获取批准** 预算
-3. **优先级** 待办事项中的故事
-4. **启动开发**：`@dev` 实现 `story-1.1`
-5. **监控进度** 通过ClickUp/GitHub
-
----
-
-*生成时间：2026-02-04*
-*工作流版本：2.0*
-*维护者：@devops*