Files
KingClawArmy/docs/agent-skill-mapping.md
Chris e894446416 fix: 修正審查員 P7-P8 問題
P7: envInputs 從 .paperclip.yaml 頂層移至 projects.daily-quant-pipeline.inputs.env
    讓 importer 能正確讀取 env input 並進 manifest
    同步補入 ALPACA_API_KEY / FMP_API_KEY 需求聲明

P8: .mcp.json 補齊 alpaca 與 fmp MCP server
    docs/agent-skill-mapping.md 新增 Runtime 狀態說明表(active / needs-key / local-runtime)
    docs/mcp-plan.md 狀態從「規劃中」改為「已配置」,補 Alpaca/FMP 安裝說明

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-10 21:31:44 +00:00

286 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Agent 技能配置對應表
> 版本v3.1Runtime 狀態標記完整化)
> 更新日期2026-04-11
> 來源:基於 tradermonty/claude-trading-skills、ginlix-ai/langalpha、anthropics/skills 的調查結果
> 原則:技能來自真實開源 repo不自製台股美股雙市場覆蓋
> 版本說明:目前 SKILL.md 均為摘要參考版Summary Reference提供方法論架構與 MCP 需求聲明。完整 reference/ 與 scripts/ 目錄將於後續版本補齊。
## Runtime 狀態說明
各 skill 依啟用難度分為三個狀態:
| 狀態 | 說明 |
|---|---|
| ✅ **active** | MCP 已配置於 `.mcp.json`,可直接啟用 |
| 🔑 **needs-key** | MCP 已配置,但需要額外 API key`.paperclip.yaml` envInputs |
| 🐍 **local-runtime** | 需要本地 Python 環境scipy / statsmodels / pandas 等) |
**整體 runtime 狀態:**
| Skill | 狀態 | 依賴 |
|---|---|---|
| `yahoo-finance-*` 相關 skills | ✅ active | yahoo-finance MCP無需 key |
| `casual-market` 相關 skills | ✅ active | casual-market MCP無需 key |
| `tradingview` 相關 skills | ✅ active | tradingview MCP無需 key |
| `morning-note``macro-regime-detector` 等 | 🔑 needs-key | FRED_API_KEY |
| `market-breadth-analyzer``sector-overview` 等 | 🔑 needs-key | FUGLE_API_KEY台股 |
| `earnings-calendar``economic-calendar-fetcher` | 🔑 needs-key | FMP_API_KEY |
| `portfolio-manager` | 🔑 needs-key | ALPACA_API_KEY + ALPACA_API_SECRET |
| `pair-trade-screener` | 🐍 local-runtime | Python + scipy + statsmodels |
| `trader-memory-core` | ✅ active | claude_local 檔案系統(已內建) |
---
---
## 技能分配總覽
| Agent | 職稱 | 技能數 | 主要技能來源 |
|---|---|---|---|
| `finance-researcher` | 財經情報研究員 | 9 | tradermonty、langalpha |
| `market-structure-researcher` | 市場結構研究員 | 8 | tradermonty、langalpha |
| `bullish-researcher` | 多方研究員 | 12 | tradermonty、langalpha |
| `bearish-researcher` | 空方研究員 | 7 | tradermonty、langalpha |
| `quant-strategist` | 量化策略師 | 9 | tradermonty、langalpha |
| `quant-engineer` | 回測工程師 | 7 | tradermonty |
| `data-analyst` | 資料分析師 | 5 | tradermonty、anthropics |
| `reviewer` | 審查員 | 4 | tradermonty、langalpha |
| `secretary` | 秘書 | 3 | tradermonty、anthropics |
| `ceo` | 執行長 | 5 | tradermonty、anthropics |
| `xiao-an` | 小安 | 2 | anthropics |
**技能檔案總計53 個 SKILL.md全在 skills/ 目錄)**
**技能配置總計72 個分配(含共用技能跨 Agent 重複引用)**
---
## 詳細配置
### 執行長ceo
**職責**:接收指令、拆解任務、派工追蹤、組裝最終決策包
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `stanley-druckenmiller-investment` | Druckenmiller 投資哲學 | tradermonty | 宏觀驅動投資框架、催化劑識別 |
| `portfolio-manager` | 投資組合管理師 | tradermonty | 組合層級風險與曝險管理 |
| `exposure-coach` | 曝險管理教練 | tradermonty | 統一曝險建議,平衡多空風險 |
| `doc-coauthoring` | 文件共同創作 | anthropics | 最終決策包與報告起草 |
| `internal-comms` | 內部溝通 | anthropics | 跨 Agent 狀態更新與通知 |
---
### 財經情報研究員finance-researcher
**職責**:蒐集財經新聞、總體經濟數據、行事曆事件,評估市場情緒
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `market-news-analyst` | 市場新聞分析師 | tradermonty | 過去10天市場新聞影響評估 |
| `economic-calendar-fetcher` | 經濟行事曆擷取器 | tradermonty | 未來7-90天重大經濟事件 |
| `market-environment-analysis` | 總體市場環境分析 | tradermonty | 全球宏觀簡報(含台股) |
| `earnings-calendar` | 財報行事曆 | tradermonty | 即將發布的美股財報 |
| `morning-note` | 盤前晨報 | langalpha | 每日市場摘要(含視覺化) |
| `theme-detector` | 市場主題偵測器 | tradermonty | 跨資產主題識別與追蹤 |
| `catalyst-calendar` | 催化劑行事曆 | langalpha | 近期重大催化事件彙整 |
| `earnings-preview` | 財報預覽 | langalpha | 財報前情勢分析與預期管理 |
| `earnings-analysis` | 財報後分析 | langalpha | 財報數據解讀與管理層訊號 |
**台股覆蓋**`market-environment-analysis` 涵蓋台股加權指數;`morning-note` 透過 CasualMarket MCP 取得台股數據;`catalyst-calendar` 涵蓋台灣重要政策與財報事件
---
### 市場結構研究員market-structure-researcher
**職責**:技術結構分析、關鍵價位、流動性、趨勢方向、板塊輪動
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `technical-analyst` | 技術分析師 | tradermonty | 週線技術分析(趨勢、支撐壓力、均線、型態) |
| `market-breadth-analyzer` | 市場廣度分析器 | tradermonty | 六成分廣度綜合評分 |
| `sector-analyst` | 板塊輪動分析師 | tradermonty | 板塊輪動模式與市場週期 |
| `uptrend-analyzer` | 漲勢分析器 | tradermonty | 五成分漲勢健康度評分 |
| `macro-regime-detector` | 總經環境偵測器 | tradermonty | 跨資產比率分析5種環境分類 |
| `breadth-chart-analyst` | 廣度圖表分析師 | tradermonty | McClellan、A/D Line 等廣度圖表詮釋 |
| `sector-overview` | 板塊概況分析 | langalpha | 板塊基本面趨勢、龍頭股、估值水平 |
| `competitive-analysis` | 競爭分析 | langalpha | Porter 五力、競爭格局、市場份額動態 |
**台股覆蓋**:技術分析師和廣度分析器適用台股;`sector-overview` 涵蓋台積電、聯發科、富邦金等台股龍頭
---
### 多方研究員bullish-researcher
**職責**:整理利多因素、做多論點、催化劑、成長股選股
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `us-stock-analysis` | 美股個股分析 | tradermonty | 基本面+技術面完整股票研究 |
| `institutional-flow-tracker` | 法人資金流向追蹤器 | tradermonty | 13F 持倉追蹤,聰明錢動向 |
| `canslim-screener` | CANSLIM 選股篩選器 | tradermonty | O'Neil 七成分成長股篩選 |
| `vcp-screener` | VCP 篩選器 | tradermonty | Minervini 波動收縮型態偵測 |
| `ftd-detector` | 跟進日偵測器 | tradermonty | 市場底部跟進日確認 |
| `initiating-coverage` | 啟動追蹤報告 | langalpha | 30-50頁機構級股票研究報告 |
| `pead-screener` | PEAD 財報後漂移篩選器 | tradermonty | 財報後動能漂移效應追蹤 |
| `earnings-trade-analyzer` | 財報交易分析師 | tradermonty | 財報前後選股、期權策略評估 |
| `earnings-preview` | 財報預覽 | langalpha | 財報前情勢分析(共用) |
| `earnings-analysis` | 財報後分析 | langalpha | 財報數據解讀(共用) |
| `dcf-model` | DCF 估值模型 | langalpha | 折現現金流內在價值計算 |
| `comps-analysis` | 可比公司分析 | langalpha | 同業倍數相對估值 |
| `options-strategy-advisor` | 選擇權策略顧問 | tradermonty | 買權/賣權策略建議(做多情境) |
**台股覆蓋**`institutional-flow-tracker` 透過 CasualMarket MCP 追蹤台股外資買賣超;`dcf-model``comps-analysis` 適用台積電、聯發科等台股
---
### 空方研究員bearish-researcher
**職責**:整理利空因素、做空論點、風險事件、市場頂部識別
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `us-market-bubble-detector` | 美股泡沫偵測器 | tradermonty | Minsky框架泡沫機械化評分 |
| `market-top-detector` | 市場頂部偵測器 | tradermonty | 六成分頂部風險綜合評分 |
| `downtrend-duration-analyzer` | 下跌持續時間分析器 | tradermonty | 歷史下跌持續時間統計分析 |
| `competitive-analysis` | 競爭分析 | langalpha | 競爭威脅識別(空方視角:護城河崩解) |
| `sector-overview` | 板塊概況分析 | langalpha | 弱勢板塊識別(做空標的) |
| `comps-analysis` | 可比公司分析 | langalpha | 高估股票識別(高估相對同業) |
| `options-strategy-advisor` | 選擇權策略顧問 | tradermonty | 保護性賣權、看跌策略建議 |
---
### 量化策略師quant-strategist
**職責**收斂多空觀點、策略論點、Edge 研究流程管理、組合管理
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `scenario-analyzer` | 情境分析引擎 | tradermonty | 18個月牛熊基準情境預測 |
| `edge-signal-aggregator` | 優勢訊號整合器 | tradermonty | 多技能輸出加權聚合 |
| `exposure-coach` | 曝險管理教練 | tradermonty | 統一曝險建議(共用) |
| `edge-pipeline-orchestrator` | Edge 流程協調器 | tradermonty | 端到端Edge研究流程管理 |
| `trade-hypothesis-ideator` | 交易假設發想器 | tradermonty | 可偽證假設卡生成 |
| `thesis-tracker` | 投資論點追蹤器 | langalpha | 投資論點長期追蹤 |
| `macro-regime-detector` | 總經環境偵測器 | tradermonty | 跨資產環境判斷(共用) |
| `stanley-druckenmiller-investment` | Druckenmiller 投資哲學 | tradermonty | 宏觀驅動策略框架(共用) |
| `portfolio-manager` | 投資組合管理師 | tradermonty | 組合層級風險評估 |
---
### 回測工程師quant-engineer
**職責**:策略程式化、回測執行、績效報告、倉位計算
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `backtest-expert` | 回測專家 | tradermonty | 完整策略驗證框架(含評估腳本) |
| `position-sizer` | 部位規模計算器 | tradermonty | 固定分數/ATR/凱利公式計算 |
| `strategy-pivot-designer` | 策略轉向設計師 | tradermonty | 偵測回測停滯,提出結構性轉向 |
| `data-quality-checker` | 資料品質檢查器 | tradermonty | 財金數據驗證(共用) |
| `pair-trade-screener` | 配對交易篩選器 | tradermonty | 統計套利對篩選ADF/協整檢驗) |
| `options-strategy-advisor` | 選擇權策略顧問 | tradermonty | 期權結構設計Delta/Gamma管理 |
| `portfolio-manager` | 投資組合管理師 | tradermonty | 多策略組合管理框架 |
---
### 資料分析師data-analyst
**職責**回測結果分析、KPI 計算、風險識別、績效報告、Edge 洞察
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `signal-postmortem` | 訊號事後分析 | tradermonty | 訊號結果記錄與聚合器權重反饋 |
| `edge-candidate-agent` | Edge 候選代理人 | tradermonty | 每日觀察→可重現研究票據 |
| `xlsx` | Excel 試算表 | anthropics | 標準金融建模試算表生成 |
| `edge-hint-extractor` | Edge 線索萃取器 | tradermonty | 從非結構化數據萃取可測試Edge線索 |
| `edge-concept-synthesizer` | Edge 概念合成器 | tradermonty | 多訊號整合→可量化Edge概念 |
---
### 審查員reviewer
**職責**品質審查、風險識別、Pass/Revise/Block 判定
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `edge-strategy-reviewer` | 策略審查工具 | tradermonty | 八標準策略品質審查 → PASS/REVISE/FAIL |
| `data-quality-checker` | 資料品質檢查器 | tradermonty | 數據準確性驗證(共用) |
| `competitive-analysis` | 競爭分析 | langalpha | 審查護城河論點是否合理 |
| `comps-analysis` | 可比公司分析 | langalpha | 審查估值假設是否合理 |
---
### 秘書secretary
**職責**:會議記錄、狀態追蹤、長期記憶維護
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `trader-memory-core` | 交易員記憶核心 | tradermonty | 持久論點生命週期管理2500行核心技能 |
| `doc-coauthoring` | 文件共同創作 | anthropics | 結構化文件起草(三階段工作流程) |
| `internal-comms` | 內部溝通 | anthropics | 狀態更新、會議摘要、事件報告 |
---
### 小安xiao-an
**職責**:陪伴對話、輕鬆互動
| 技能 Slug | 技能中文名 | 來源 Repo | 用途 |
|---|---|---|---|
| `doc-coauthoring` | 文件共同創作 | anthropics | 協助整理輕鬆對話紀錄 |
| `internal-comms` | 內部溝通 | anthropics | 友善訊息撰寫格式 |
---
## 共用技能說明
部分技能被多個 Agent 共用Paperclip 支援多 Agent 引用同一 Skill 目錄):
| 技能 | 共用的 Agent |
|---|---|
| `macro-regime-detector` | market-structure-researcher、quant-strategist |
| `data-quality-checker` | quant-engineer、reviewer |
| `exposure-coach` | ceo、quant-strategist |
| `stanley-druckenmiller-investment` | ceo、quant-strategist |
| `portfolio-manager` | ceo、quant-strategist、quant-engineer |
| `competitive-analysis` | market-structure-researcher、bearish-researcher、reviewer |
| `sector-overview` | market-structure-researcher、bearish-researcher |
| `comps-analysis` | bullish-researcher、bearish-researcher、reviewer |
| `options-strategy-advisor` | bullish-researcher、bearish-researcher、quant-engineer |
| `earnings-preview` | finance-researcher、bullish-researcher |
| `earnings-analysis` | finance-researcher、bullish-researcher |
| `doc-coauthoring` | ceo、secretary、xiao-an |
| `internal-comms` | ceo、secretary、xiao-an |
---
## OctagonAI Skills 備注(付費方案)
OctagonAI 的 66 個技能品質極高,涵蓋 SEC 申報分析、財報電話、財務健康評分等。
但所有技能均需要 **Octagon MCP Server**(付費服務)。
未來可考慮啟用的高價值技能:
- `financial-health-scores` — Altman Z-Score、Piotroski Score適合空方研究員
- `sec-risk-factors` — SEC 風險因素萃取(適合空方研究員)
- `earnings-call-insights` — 財報電話關鍵洞察(適合財經情報研究員)
- `financial-analyst-master` — 機構級股票研究報告(適合 CEO 層級)
---
## Skill 目錄結構規範
```
skills/
technical-analyst/
SKILL.md # 必要主要技能定義YAML frontmatter + 說明)
reference/ # 選用:參考文件目錄
indicators.md # 指標詳細說明
patterns.md # 型態識別指南
scripts/ # 選用:可執行腳本
```
SKILL.md 保持在 500 行以內,詳細內容放 reference/ 目錄。
參考文件在 Agent 判斷需要時才載入,不佔基礎 context。