# 工作流：棕地项目发现

**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. 添加影响的视觉图表

---

## 参考

### 工作流文件

| 文件 | 位置 |
|------|------|
| 工作流定义 | `.aiox-core/development/workflows/brownfield-discovery.yaml` |
| 任务：brownfield-create-epic | `.aiox-core/development/tasks/brownfield-create-epic.md` |
| 任务：brownfield-create-story | `.aiox-core/development/tasks/brownfield-create-story.md` |
| 任务：db-schema-audit | `.aiox-core/development/tasks/db-schema-audit.md` |
| 任务：security-audit | `.aiox-core/development/tasks/security-audit.md` |

### 代理

| 代理 | 位置 |
|------|------|
| @architect | `.aiox-core/development/agents/architect.md` |
| @data-engineer | `.aiox-core/development/agents/data-engineer.md` |
| @ux-design-expert | `.aiox-core/development/agents/ux-design-expert.md` |
| @qa | `.aiox-core/development/agents/qa.md` |
| @analyst | `.aiox-core/development/agents/analyst.md` |
| @pm | `.aiox-core/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*