<!--
  翻译：zh-CN（简体中文）
  原文：/docs/aiox-agent-flows/analyst-system.md
  最后同步：2026-02-22
-->

# 分析师代理 (@analyst) 系统 - AIOX

> **版本：** 1.0.0
> **创建日期：** 2026-02-04
> **负责人：** @analyst (Atlas)
> **状态：** 官方文档

---

## 概述

本文档描述 **@analyst (Atlas)** 代理的完整系统，包括所有涉及的文件、工作流程、可用命令、模板和代理之间的集成。

分析师代理设计用于：
- 进行市场研究和竞争分析
- 促进结构化的头脑风暴会话
- 创建项目简介和深度研究提示
- 为决策提供可操作的见解
- 支持项目发现（棕地文档）
- 生成高管意识报告

---

## 代理资料

| 属性 | 值 |
|----------|-------|
| **名称** | Atlas |
| **ID** | analyst |
| **标题** | 业务分析师 |
| **图标** | :mag: |
| **原型** | 解码者 |
| **星座** | :scorpius: 天蝎座 |
| **语气** | 分析性、好奇、创意 |
| **签名** | "-- Atlas，探究真相 :mag_right:" |

### 核心原则

1. **好奇心驱动的探究** - 主动提问以发现潜在真相
2. **客观和基于证据的分析** - 基于可验证的数据
3. **战略情境化** - 在更广泛的战略背景下定位
4. **促进清晰和共同理解** - 精确表达需求
5. **创意探索和发散思维** - 收敛前广泛生成想法
6. **结构化和有条理的方法** - 系统方法确保全面性
7. **以行动为导向的输出** - 清晰可操作的交付物
8. **协作伙伴关系** - 迭代细化的伙伴关系
9. **保持广泛视角** - 对市场趋势的意识
10. **信息诚信** - 准确表示来源

---

## 完整文件列表

### 代理核心文件

| 文件 | 目的 |
|---------|-----------|
| `.aiox-core/development/agents/analyst.md` | 分析师代理核心定义 |
| `.claude/commands/AIOX/agents/analyst.md` | 用于激活 @analyst 的 Claude Code 命令 |

### 分析师任务

| 文件 | 命令 | 目的 |
|---------|---------|-----------|
| `.aiox-core/development/tasks/facilitate-brainstorming-session.md` | `*brainstorm {topic}` | 主要任务 - 促进结构化头脑风暴会话 |
| `.aiox-core/development/tasks/analyst-facilitate-brainstorming.md` | `*brainstorm {topic}` | 头脑风暴任务的交互变体 |
| `.aiox-core/development/tasks/create-deep-research-prompt.md` | `*research-prompt {topic}` | 生成深度研究调查提示 |
| `.aiox-core/development/tasks/advanced-elicitation.md` | `*elicit` | 高级需求获取会话 |
| `.aiox-core/development/tasks/create-doc.md` | `*doc-out` | 从 YAML 模板创建文档 |
| `.aiox-core/development/tasks/document-project.md` | `*create-project-brief` | 现有项目文档 |
| `.aiox-core/development/tasks/calculate-roi.md` | (相关) | ROI 和成本节约计算 |

### 相关分析任务

| 文件 | 目的 |
|---------|-----------|
| `.aiox-core/development/tasks/analyze-brownfield.md` | 棕地项目分析 |
| `.aiox-core/development/tasks/analyze-framework.md` | 现有框架分析 |
| `.aiox-core/development/tasks/analyze-performance.md` | 性能分析 |
| `.aiox-core/development/tasks/analyze-project-structure.md` | 项目结构分析 |
| `.aiox-core/development/tasks/analyze-cross-artifact.md` | 跨工件分析 |

### 分析师模板

| 文件 | 目的 |
|---------|-----------|
| `.aiox-core/product/templates/project-brief-tmpl.yaml` | 项目简介模板 |
| `.aiox-core/product/templates/market-research-tmpl.yaml` | 市场研究模板 |
| `.aiox-core/product/templates/competitor-analysis-tmpl.yaml` | 竞争分析模板 |
| `.aiox-core/product/templates/brainstorming-output-tmpl.yaml` | 头脑风暴会话输出模板 |

### 数据文件

| 文件 | 目的 |
|---------|-----------|
| `.aiox-core/development/data/aiox-kb.md` | AIOX 知识库 |
| `.aiox-core/development/data/brainstorming-techniques.md` | 可用的头脑风暴技术 |

### 使用分析师的工作流

| 文件 | 阶段 | 目的 |
|---------|------|-----------|
| `.aiox-core/development/workflows/greenfield-fullstack.yaml` | 阶段 1 | 发现与规划 - 创建 project-brief.md |
| `.aiox-core/development/workflows/brownfield-discovery.yaml` | 阶段 9 | 高管意识报告 |

---

## 流程图：分析师完整系统

```mermaid
flowchart TB
    subgraph INPUTS["输入 - 信息来源"]
        USER["用户/利益相关者"]
        DOCS["现有文档"]
        MARKET["市场数据"]
        COMPETITORS["竞争对手数据"]
    end

    USER -->|"初始背景"| ANALYST
    DOCS -->|"参考"| ANALYST
    MARKET -->|"EXA 研究"| ANALYST
    COMPETITORS -->|"分析"| ANALYST

    subgraph ANALYST["@analyst (Atlas) - 业务分析师"]
        BRAINSTORM["*brainstorm {topic}<br/>结构化会话"]
        RESEARCH["*research-prompt {topic}<br/>研究提示"]
        MARKET_RES["*perform-market-research<br/>市场研究"]
        COMPETITOR["*create-competitor-analysis<br/>竞争分析"]
        BRIEF["*create-project-brief<br/>项目简介"]
        ELICIT["*elicit<br/>高级获取"]
    end

    BRAINSTORM --> OUTPUT_BRAIN["brainstorming-session-results.md"]
    RESEARCH --> OUTPUT_PROMPT["research-prompt.md"]
    MARKET_RES --> OUTPUT_MARKET["market-research.md"]
    COMPETITOR --> OUTPUT_COMP["competitor-analysis.md"]
    BRIEF --> OUTPUT_BRIEF["project-brief.md"]
    ELICIT --> OUTPUT_ELICIT["细化的见解"]

    subgraph OUTPUTS["输出 - 交付物"]
        OUTPUT_BRAIN
        OUTPUT_PROMPT
        OUTPUT_MARKET
        OUTPUT_COMP
        OUTPUT_BRIEF
        OUTPUT_ELICIT
    end

    OUTPUTS --> HANDOFF["交接给 @pm"]

    style INPUTS fill:#e1f5fe
    style ANALYST fill:#fff3e0
    style OUTPUTS fill:#e8f5e9
    style HANDOFF fill:#f3e5f5
```

### 头脑风暴流程图

```mermaid
flowchart TD
    START["开始：*brainstorm {topic}"] --> SETUP["阶段 1：设置<br/>4 个背景问题"]

    SETUP --> Q1["1. 我们在头脑风暴什么？"]
    Q1 --> Q2["2. 约束或参数？"]
    Q2 --> Q3["3. 目标：广泛探索还是聚焦？"]
    Q3 --> Q4["4. 想要结构化文档？"]

    Q4 --> APPROACH["阶段 2：方法选择"]

    APPROACH --> OPT1["1. 用户选择技术"]
    APPROACH --> OPT2["2. 分析师推荐技术"]
    APPROACH --> OPT3["3. 随机选择"]
    APPROACH --> OPT4["4. 渐进式流程"]

    OPT1 --> EXEC
    OPT2 --> EXEC
    OPT3 --> EXEC
    OPT4 --> EXEC

    EXEC["阶段 3：交互执行"]

    subgraph CYCLE["技术周期"]
        TECH["应用技术"]
        ENGAGE["让用户参与"]
        CAPTURE["捕获想法"]
        NEXT{{"继续？"}}

        TECH --> ENGAGE
        ENGAGE --> CAPTURE
        CAPTURE --> NEXT
        NEXT -->|"是，同一技术"| TECH
        NEXT -->|"换技术"| TECH
    end

    EXEC --> CYCLE
    NEXT -->|"收敛"| CONVERGE["阶段 4：收敛"]

    CONVERGE --> CAT["分类想法"]
    CAT --> SYNTH["综合见解"]
    SYNTH --> DOC["生成文档"]
    DOC --> END["会话完成"]

    style START fill:#90EE90
    style END fill:#90EE90
    style CYCLE fill:#FFE4B5
```

### 会话状态图

```mermaid
stateDiagram-v2
    [*] --> CONTEXT_GATHERING: 激活
    CONTEXT_GATHERING --> APPROACH_SELECTION: 背景已收集
    APPROACH_SELECTION --> DIVERGENT_THINKING: 方法已定义

    DIVERGENT_THINKING --> TECHNIQUE_ACTIVE: 技术已选择
    TECHNIQUE_ACTIVE --> DIVERGENT_THINKING: 换技术
    TECHNIQUE_ACTIVE --> TECHNIQUE_ACTIVE: 继续参与

    DIVERGENT_THINKING --> CONVERGENT_THINKING: 想法充足
    CONVERGENT_THINKING --> CATEGORIZATION: 分类
    CATEGORIZATION --> SYNTHESIS: 综合
    SYNTHESIS --> DOCUMENTATION: 文档化
    DOCUMENTATION --> [*]: 会话完成

    note right of DIVERGENT_THINKING: 热身：5-10 分钟<br/>生成：20-30 分钟
    note right of CONVERGENT_THINKING: 收敛：15-20 分钟
    note right of SYNTHESIS: 综合：10-15 分钟
```

---

## 流程图：与其他代理的集成

```mermaid
flowchart TB
    subgraph DISCOVERY["发现阶段"]
        direction TB
        ANALYST_WORK["@analyst<br/>研究与头脑风暴"]
        PROJECT_BRIEF["project-brief.md"]
        MARKET_RESEARCH["market-research.md"]
        COMPETITOR_ANALYSIS["competitor-analysis.md"]

        ANALYST_WORK --> PROJECT_BRIEF
        ANALYST_WORK --> MARKET_RESEARCH
        ANALYST_WORK --> COMPETITOR_ANALYSIS
    end

    subgraph PLANNING["规划阶段"]
        direction TB
        PM_WORK["@pm (Morgan)<br/>产品策略"]
        PRD["prd.md"]

        PROJECT_BRIEF --> PM_WORK
        MARKET_RESEARCH --> PM_WORK
        COMPETITOR_ANALYSIS --> PM_WORK
        PM_WORK --> PRD
    end

    subgraph DESIGN["设计阶段"]
        direction TB
        UX_WORK["@ux-design-expert<br/>前端规范"]
        FRONTEND_SPEC["front-end-spec.md"]

        PRD --> UX_WORK
        UX_WORK --> FRONTEND_SPEC
    end

    subgraph ARCHITECTURE["架构阶段"]
        direction TB
        ARCH_WORK["@architect<br/>全栈架构"]
        ARCH_DOC["fullstack-architecture.md"]

        PRD --> ARCH_WORK
        FRONTEND_SPEC --> ARCH_WORK
        ARCH_WORK --> ARCH_DOC
    end

    subgraph VALIDATION["验证阶段"]
        direction TB
        PO_WORK["@po (Pax)<br/>工件验证"]

        PROJECT_BRIEF --> PO_WORK
        PRD --> PO_WORK
        FRONTEND_SPEC --> PO_WORK
        ARCH_DOC --> PO_WORK
    end

    style DISCOVERY fill:#e3f2fd
    style PLANNING fill:#fff3e0
    style DESIGN fill:#fce4ec
    style ARCHITECTURE fill:#e8f5e9
    style VALIDATION fill:#f3e5f5
```

### 棕地发现工作流流程

```mermaid
flowchart LR
    subgraph PHASES["棕地发现 - 10 阶段"]
        P1["阶段 1-3<br/>数据收集"]
        P4["阶段 4<br/>整合"]
        P5_7["阶段 5-7<br/>验证"]
        P8["阶段 8<br/>最终评估"]
        P9["阶段 9<br/>@analyst<br/>高管报告"]
        P10["阶段 10<br/>史诗与故事"]

        P1 --> P4
        P4 --> P5_7
        P5_7 --> P8
        P8 --> P9
        P9 --> P10
    end

    P9 --> EXEC_REPORT["TECHNICAL-DEBT-REPORT.md"]

    style P9 fill:#DDA0DD
    style EXEC_REPORT fill:#90EE90
```

---

## 命令到任务的映射

### 研究与分析命令

| 命令 | 任务文件 | 操作 |
|---------|-----------|----------|
| `*perform-market-research` | `create-doc.md` + 模板 | 创建市场研究报告 |
| `*create-competitor-analysis` | `create-doc.md` + 模板 | 创建详细竞争分析 |
| `*research-prompt {topic}` | `create-deep-research-prompt.md` | 生成深度研究提示 |

### 构思与发现命令

| 命令 | 任务文件 | 操作 |
|---------|-----------|----------|
| `*brainstorm {topic}` | `facilitate-brainstorming-session.md` | 促进结构化头脑风暴会话 |
| `*create-project-brief` | `document-project.md` | 创建项目简介 |
| `*elicit` | `advanced-elicitation.md` | 高级获取会话 |

### 工具命令

| 命令 | 操作 |
|---------|----------|
| `*help` | 显示所有可用命令 |
| `*doc-out` | 输出完整文档 |
| `*session-info` | 显示当前会话详情 |
| `*guide` | 代理使用指南 |
| `*yolo` | 切换跳过确认 |
| `*exit` | 退出分析师模式 |

---

## 模板和数据结构

### 项目简介模板

```yaml
template:
  id: project-brief-template-v2
  name: 项目简介
  version: 2.0
  output:
    format: markdown
    filename: docs/brief.md
```

**主要部分：**
- 执行摘要
- 问题陈述
- 建议解决方案
- 目标用户（主要/次要）
- 目标与成功指标
- MVP 范围（核心功能/范围外）
- MVP 后愿景
- 技术考虑
- 约束与假设
- 风险与开放问题

### 市场研究模板

```yaml
template:
  id: market-research-template-v2
  name: 市场研究报告
  version: 2.0
  output:
    format: markdown
    filename: docs/market-research.md
```

**主要部分：**
- 执行摘要
- 研究目标与方法
- 市场概览（TAM/SAM/SOM、趋势）
- 客户分析（细分、JTBD、旅程）
- 竞争格局
- 行业分析（波特五力）
- 机会评估
- 战略建议

### 竞争分析模板

```yaml
template:
  id: competitor-analysis-template-v2
  name: 竞争分析报告
  version: 2.0
  output:
    format: markdown
    filename: docs/competitor-analysis.md
```

**主要部分：**
- 执行摘要
- 分析范围与方法
- 竞争格局概览
- 单个竞争对手档案
- 比较分析（功能、SWOT、定位）
- 战略分析（蓝海、漏洞）
- 战略建议
- 监控与情报计划

### 头脑风暴输出模板

```yaml
template:
  id: brainstorming-output-template-v2
  name: 头脑风暴会话结果
  version: 2.0
  output:
    format: markdown
    filename: docs/brainstorming-session-results.md
```

**主要部分：**
- 执行摘要（主题、技术、想法数量）
- 技术会话（每个使用的技术）
- 想法分类
  - 即时机会
  - 未来创新
  - 登月计划
  - 见解与学习
- 行动规划（前 3 优先事项）
- 反思与后续

---

## 深度研究流程

### 研究焦点类型

1. **产品验证研究** - 验证假设和市场契合度
2. **市场机会研究** - 市场规模和潜力
3. **用户和客户研究** - 人物画像、JTBD、痛点
4. **竞争情报研究** - 详细竞争对手分析
5. **技术和创新研究** - 趋势和技术评估
6. **行业和生态系统研究** - 价值链和动态
7. **战略选项研究** - 评估战略方向
8. **风险和可行性研究** - 识别和评估风险
9. **自定义研究焦点** - 定制目标

### 研究提示结构

```markdown
## 研究目标
[明确的目标陈述]

## 背景上下文
[来自输入的相关信息]

## 研究问题
### 主要问题（必须回答）
1. [具体、可操作的问题]
...

### 次要问题（可选）
1. [支持性问题]
...

## 研究方法
### 信息来源
- [来源类型和优先级]

### 分析框架
- [具体框架]

## 预期交付物
### 执行摘要
- 关键发现和见解
- 关键影响
- 建议的行动

## 成功标准
[如何评估研究是否达到目标]
```

---

## 工具和集成

### 可用工具

| 工具 | 目的 |
|------------|-----------|
| **exa** | 高级网络搜索市场和技术 |
| **context7** | 库文档查找 |
| **google-workspace** | 研究文档（Drive、Docs、Sheets） |
| **clickup** | 捕获和组织想法 |

### 与其他代理的集成

| 代理 | 协作类型 |
|--------|---------------------|
| **@pm (Morgan)** | 分析师为 PRD 创建提供研究和分析 |
| **@po (Pax)** | 分析师提供市场见解和竞争分析 |
| **@architect** | 分析师可提供技术研究 |
| **@ux-design-expert** | 分析师提供用户研究支持 UX 决策 |

---

## 执行模式

### 1. YOLO 模式 - 快速自主（0-1 提示）
- 带日志的自主决策
- 与用户最小交互
- **最适合：** 简单、确定性的任务

### 2. 交互模式 - 平衡教育（5-10 提示）[默认]
- 明确的决策检查点
- 教育性解释
- **最适合：** 学习、复杂决策

### 3. 预检规划 - 全面规划
- 任务分析阶段（识别歧义）
- 零歧义执行
- **最适合：** 模糊需求、关键工作

---

## 最佳实践

### 市场研究

1. **定义清晰目标** - 知道研究将支持什么决策
2. **使用多个来源** - 结合一手和二手来源
3. **尽可能量化** - TAM/SAM/SOM 有清晰计算
4. **识别假设** - 记录限制和前提
5. **聚焦可操作见解** - 不仅是数据，还有建议

### 竞争分析

1. **优先排序竞争对手** - 使用优先级矩阵（市场份额 vs 威胁）
2. **深度分析优先级 1-2** - 详细档案
3. **持续监控** - 建立更新节奏
4. **识别蓝海** - 寻找未竞争的市场空间
5. **记录来源** - 用于验证和未来更新

### 头脑风暴会话

1. **做促进者，而非生成者** - 引导用户生成自己的想法
2. **一次一个技术** - 不要混合多个技术
3. **数量优先于质量** - 目标：60 分钟 100 个想法
4. **延迟判断** - 先生成，后评估
5. **记录所有** - 捕获即使"疯狂"的想法
6. **管理精力** - 监控参与度，提供休息

### 高级获取

1. **方法前的背景** - 选择方法前分析内容
2. **使用 1-9 格式** - 始终展示编号选项
3. **提供详细理由** - 解释权衡和决策
4. **等待响应** - 不要在没有用户输入时继续
5. **保持简洁** - 聚焦可操作见解

---

## 故障排除

### 头脑风暴会话停滞

**症状：** 用户停止生成想法，回应简短

**解决方案：**
1. 检查精力水平："您对这个方向感觉如何？"
2. 提供换技术："想尝试不同的方法吗？"
3. 使用更具体的提示
4. 休息后再继续

### 研究数据不足

**症状：** EXA 返回少量结果，小众市场

**解决方案：**
1. 扩大搜索范围（相关术语）
2. 使用相邻市场的类比
3. 结合一手研究（访谈）
4. 清楚记录差距和不确定性

### 项目简介不完整

**症状：** 部分模糊，缺乏具体性

**解决方案：**
1. 使用高级获取深入
2. 要求具体例子
3. 用场景挑战假设
4. 必要时多会话迭代

### 竞争分析肤浅

**症状：** 只有竞争对手列表没有见解

**解决方案：**
1. 应用结构化框架（波特、SWOT）
2. 聚焦差异化和漏洞
3. 包括定位分析
4. 生成具体战略建议

---

## 参考

### 主要任务

- [任务：facilitate-brainstorming-session.md](.aiox-core/development/tasks/facilitate-brainstorming-session.md)
- [任务：create-deep-research-prompt.md](.aiox-core/development/tasks/create-deep-research-prompt.md)
- [任务：advanced-elicitation.md](.aiox-core/development/tasks/advanced-elicitation.md)
- [任务：create-doc.md](.aiox-core/development/tasks/create-doc.md)
- [任务：document-project.md](.aiox-core/development/tasks/document-project.md)

### 模板

- [模板：project-brief-tmpl.yaml](.aiox-core/product/templates/project-brief-tmpl.yaml)
- [模板：market-research-tmpl.yaml](.aiox-core/product/templates/market-research-tmpl.yaml)
- [模板：competitor-analysis-tmpl.yaml](.aiox-core/product/templates/competitor-analysis-tmpl.yaml)
- [模板：brainstorming-output-tmpl.yaml](.aiox-core/product/templates/brainstorming-output-tmpl.yaml)

### 工作流

- [工作流：greenfield-fullstack.yaml](.aiox-core/development/workflows/greenfield-fullstack.yaml)
- [工作流：brownfield-discovery.yaml](.aiox-core/development/workflows/brownfield-discovery.yaml)

### 代理

- [代理：analyst.md](.aiox-core/development/agents/analyst.md)

---

## 摘要

| 方面 | 详情 |
|---------|----------|
| **核心任务总数** | 6 个任务文件 |
| **模板总数** | 4 个 YAML 模板 |
| **研究命令** | 3 个（`*perform-market-research`、`*create-competitor-analysis`、`*research-prompt`） |
| **构思命令** | 3 个（`*brainstorm`、`*create-project-brief`、`*elicit`） |
| **使用的工作流** | 2 个（greenfield-fullstack、brownfield-discovery） |
| **消费代理** | @pm、@po、@architect、@ux-design-expert |
| **集成工具** | exa、context7、google-workspace、clickup |
| **执行模式** | 3 种（YOLO、交互式、预检） |

---

## 变更日志

| 日期 | 作者 | 描述 |
|------|-------|-----------|
| 2026-02-04 | @analyst | 创建包含流程图和完整映射的初始文档 |

---

*-- Atlas，探究真相 :mag_right:*