# Repository Agent Guide — 金融研究助手

本專案是一套 AI 金融研究工具，使用 Google Antigravity 的多 Agent 協作架構。

## 必讀檔案（開始任何工作前）

1. `mission.md` — 高層目標與成功標準
2. `.antigravity/rules.md` — AI 行為規則、數據來源規範、反幻覺機制
3. `CONTEXT.md` — 專案架構與技術細節
4. `.context/` 目錄下所有 `.md` — 金融知識庫（自動注入 prompt）

## 架構概覽

```
antigravity-finance/
├── .antigravity/rules.md      # AI 行為規則
├── .context/                   # 知識庫（自動注入 prompt）
│   ├── macro_sector.md         # 宏觀經濟與產業輪動
│   ├── quant_screening.md      # 量化篩選
│   ├── valuation.md            # 估值分析
│   ├── technical_analysis.md   # 技術分析
│   ├── sentiment_altdata.md    # 情緒面與另類數據
│   ├── risk_scoring.md         # 風險評分
│   ├── trade_planning.md       # 交易計劃
│   ├── session_tracking.md     # Session 延續性
│   └── chart_drawing.md        # 圖表繪製
├── .agent/workflows/           # 工作流程（使用者入口）
│   ├── forecast.md
│   ├── sector-pick.md
│   ├── deep-dive.md
│   ├── trade-plan.md
│   ├── portfolio-review.md
│   ├── market-pulse.md
│   ├── session-start.md
│   └── replay.md
├── src/agents/                 # 專業 Agent 定義
├── src/tools/                  # 工具函式
├── skills/                     # Skill 定義（含 SKILL.md）
├── artifacts/                  # 分析產出
│   ├── charts/                 # 技術圖表
│   ├── sessions/               # Session 追蹤檔
│   └── logs/                   # 執行日誌
├── mission.md                  # 任務定義
├── AGENTS.md                   # 本文件
├── CONTEXT.md                  # 專案上下文
└── README.md                   # 使用說明
```

## Agent 團隊

| Agent | 角色 | 使用的知識庫 |
|-------|------|------------|
| `forecast_analyst` | 前瞻預測分析師 | macro_sector, technical_analysis, sentiment_altdata, valuation, session_tracking |
| `sector_scout` | 產業偵察兵 | macro_sector, quant_screening |
| `stock_screener` | 選股篩選師 | quant_screening, macro_sector |
| `fundamental_analyst` | 基本面分析師 | valuation, macro_sector |
| `technical_analyst` | 技術面分析師 | technical_analysis, chart_drawing |
| `sentiment_detective` | 情緒偵探 | sentiment_altdata |
| `risk_assessor` | 風險評估官 | risk_scoring, technical_analysis, sentiment_altdata |
| `trade_strategist` | 交易策略師 | trade_planning, session_tracking, risk_scoring |
| `replay_coach` | 覆盤教練 | technical_analysis, trade_planning, risk_scoring, valuation |
| `chief_analyst` | 首席分析師（Router） | 全部（整合所有 Agent 結論） |

## 工作流程

| Workflow | 說明 | 涉及 Agent |
|----------|------|-----------|
| `forecast` | 前瞻預測 | forecast_analyst → sector_scout → technical → fundamental → chief |
| `sector-pick` | 產業選股 | sector_scout → stock_screener → chief_analyst |
| `deep-dive` | 個股深度分析 | fundamental → technical → sentiment → risk → chief |
| `trade-plan` | 交易計劃 | technical → risk → trade_strategist → chief |
| `portfolio-review` | 持倉回顧 | trade_strategist → chief |
| `market-pulse` | 市場脈搏 | sector_scout → sentiment_detective → chief |
| `session-start` | 建立 Session | trade_strategist |
| `replay` | 交易覆盤 | replay_coach |

## 多回合討論機制

每個 Agent 至少 3 回合，最後由 `chief_analyst` 整合：
1. **初步分析** → 2. **質疑補充** → 3. **最終確認（標註信心度）**

## 執行命令

```bash
# 安裝依賴
pip install -r requirements.txt

# 執行分析（透過 Antigravity IDE 的 workflow 觸發）
# 或直接在 IDE 中輸入 workflow 名稱
```