92 lines
4.0 KiB
Markdown
92 lines
4.0 KiB
Markdown
# 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 名稱
|
||
```
|
||
|