claude-code/antigravity-finance/README.md

# Antigravity Finance — AI 金融研究助手

基於 Google Antigravity 平台的金融分析工具組，涵蓋產業篩選、個股深度分析、交易計劃、覆盤學習。

## 快速開始

### 1. 安裝 Python 依賴

```bash
pip install -r requirements.txt
```

### 2. 在 Antigravity IDE 中開啟本資料夾

Antigravity 會自動讀取：
- `.antigravity/rules.md` → AI 行為規則
- `.context/*.md` → 知識庫（自動注入 prompt）
- `.agent/workflows/*.md` → 可用的工作流程
- `AGENTS.md` → Agent 指南
- `CONTEXT.md` → 專案上下文
- `mission.md` → 任務定義

### 3. 開始使用

在 Antigravity IDE 中輸入 workflow 名稱即可觸發。

---

## 可用 Workflows

| Workflow | 用途 | 範例 |
|----------|------|------|
| `full` | ⭐ **一鍵完整分析**（四維+預測+計劃+圖表） | `full NVDA` |
| `forecast` | 板塊與個股短中長期前瞻預測 | `forecast 半導體` |
| `sector-pick` | 給一個產業，推薦 5-8 隻股票 | `sector-pick AI半導體` |
| `deep-dive` | 個股四維深度分析 | `deep-dive NVDA` |
| `trade-plan` | 短中長期交易計劃 | `trade-plan NVDA` |
| `portfolio-review` | 回顧持倉，更新建議 | `portfolio-review` |
| `market-pulse` | 今日市場概況 | `market-pulse` |
| `session-start` | 建立分析追蹤 Session | `session-start NVDA` |
| `replay` | 交易覆盤，從經驗中學習 | `replay` |

---

## 典型使用流程

```
forecast 半導體               → 看短中長期哪些板塊/個股有機會
        ↓
sector-pick AI半導體          → 推薦 5-8 隻標的
        ↓
deep-dive NVDA               → 四維深度分析報告 + 圖表
        ↓
trade-plan NVDA              → 短中長期交易計劃
        ↓
portfolio-review             → 定期回顧更新
market-pulse                 → 每日市場脈搏
replay                       → 覆盤過去的交易，學習改進
```

---

## 目錄結構

```
antigravity-finance/
├── .antigravity/
│   └── rules.md                # AI 行為規則（自動讀取）
├── .context/                    # 知識庫（自動注入 prompt）
│   ├── macro_sector.md          # 宏觀經濟、Fed、景氣燈號
│   ├── 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/            # 工作流程入口
│   ├── sector-pick.md
│   ├── deep-dive.md
│   ├── trade-plan.md
│   ├── portfolio-review.md
│   ├── market-pulse.md
│   ├── session-start.md
│   └── replay.md
├── src/agents/                  # 9 個專業 Agent
│   ├── chief_analyst.md         # 首席分析師（Router）
│   ├── sector_scout.md          # 產業偵察兵
│   ├── stock_screener.md        # 選股篩選師
│   ├── fundamental_analyst.md   # 基本面分析師
│   ├── technical_analyst.md     # 技術面分析師
│   ├── sentiment_detective.md   # 情緒偵探
│   ├── risk_assessor.md         # 風險評估官
│   ├── trade_strategist.md      # 交易策略師
│   └── replay_coach.md          # 覆盤教練
├── skills/                      # Skill 定義（含 SKILL.md）
├── artifacts/                   # 分析產出
│   ├── charts/                  # 技術圖表
│   ├── sessions/                # Session 追蹤檔
│   └── logs/                    # 執行日誌
├── mission.md                   # 任務定義
├── AGENTS.md                    # Agent 指南
├── CONTEXT.md                   # 專案上下文
├── requirements.txt             # Python 依賴
└── README.md                    # 本文件
```

## 數據來源

| 市場 | 主要來源 | 用途 |
|------|---------|------|
| 美股 | [Yahoo Finance](https://finance.yahoo.com) | 報價、財報、持倉、期權 |
| 美股 | [TradingView](https://www.tradingview.com) | 技術圖表、指標 |
| 美股 | [FRED](https://fred.stlouisfed.org) | 總經數據 |
| 台股 | [Goodinfo](https://goodinfo.tw) | 基本面、籌碼、歷史股價 |
| 台股 | [TradingView](https://www.tradingview.com) | 技術圖表 |

## 與 Claude Finance 的對應

| Claude Code 格式 | Antigravity 格式 |
|------------------|-----------------|
| `.claude/commands/*.md` | `.agent/workflows/*.md` |
| `.claude/agents/*.md` | `src/agents/*.md` |
| `.claude/skills/*/SKILL.md` | `.context/*.md`（自動注入）+ `skills/` |
| `CLAUDE.md` | `.antigravity/rules.md` + `mission.md` |
| — | `AGENTS.md`（Agent 指南） |
| — | `CONTEXT.md`（專案上下文） |