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>

.mcp.json

@@ -25,6 +25,21 @@
     "tradingview": {
       "command": "uvx",
       "args": ["tradingview-mcp-server"]
+    },
+    "alpaca": {
+      "command": "uvx",
+      "args": ["alpaca-mcp-server"],
+      "env": {
+        "ALPACA_API_KEY": "${ALPACA_API_KEY}",
+        "ALPACA_API_SECRET": "${ALPACA_API_SECRET}"
+      }
+    },
+    "fmp": {
+      "command": "uvx",
+      "args": ["fmp-mcp-server"],
+      "env": {
+        "FMP_API_KEY": "${FMP_API_KEY}"
+      }
     }
   }
 }

.paperclip.yaml

@@ -80,17 +80,26 @@ agents:
         model: claude-sonnet-4-6
     status: paused
 
-envInputs:
-  - name: FRED_API_KEY
-    description: FRED (Federal Reserve Economic Data) API key — get free key at fred.stlouisfed.org
-    required: false
-  - name: FUGLE_API_KEY
-    description: Fugle MarketData API key for Taiwan stock market data — get at developer.fugle.tw
-    required: false
-
 projects:
   daily-quant-pipeline:
     leadAgentSlug: quant-strategist
+    inputs:
+      env:
+        - name: FRED_API_KEY
+          description: FRED (Federal Reserve Economic Data) API key — get free key at fred.stlouisfed.org
+          required: false
+        - name: FUGLE_API_KEY
+          description: Fugle MarketData API key for Taiwan stock market data — get at developer.fugle.tw
+          required: false
+        - name: ALPACA_API_KEY
+          description: Alpaca Markets API key for portfolio management — get at alpaca.markets
+          required: false
+        - name: ALPACA_API_SECRET
+          description: Alpaca Markets API secret
+          required: false
+        - name: FMP_API_KEY
+          description: Financial Modeling Prep API key for earnings calendar — get at financialmodelingprep.com
+          required: false
     status: active
   board-ops:
     leadAgentSlug: ceo

docs/agent-skill-mapping.md

@@ -1,11 +1,37 @@
 # Agent 技能配置對應表
 
-> 版本：v3.0（全員完整配置）
+> 版本：v3.1（Runtime 狀態標記完整化）
-> 更新日期：2026-04-10
+> 更新日期：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 檔案系統（已內建） |
+
+---
+
 ---
 
 ## 技能分配總覽

docs/mcp-plan.md

@@ -1,6 +1,6 @@
 # MCP Server 配置計畫
 
-> 狀態：規劃中（尚未實際配置）
+> 狀態：已配置（`.mcp.json` 已進 repo，env key 以 `${VAR}` 佔位）
 > 目標路徑：`KingClawArmy/.mcp.json`（Paperclip claude_local adapter 啟動時自動載入）
 > 需要安裝：`uv`、`Node.js >= 18`
 
@@ -12,11 +12,13 @@
 |---|---|---|
 | 🇹🇼 台股（上市/上櫃/加權指數） | CasualMarket、twsemcp、Fugle | 免費（Fugle 需免費 key） |
 | 🇺🇸 美股（個股/選擇權/財報） | yahoo-finance-mcp | 免費免 key |
-| 📊 美國總體經濟 | fred-mcp-server | 免費 key（已取得） |
+| 📊 美國總體經濟 | fred-mcp-server | 需 FRED_API_KEY（免費申請） |
 | 🌍 全球總體經濟 | openecon-data（雲端） | 免費免 key |
 | 📡 全球股市篩選 | tradingview-mcp-server | 免費免 key |
 | ₿ 加密貨幣 | binance-mcp-server | 需 Binance API key |
 | 📋 選擇權分析 | mcp-optionsflow | 免費免 key（需 clone） |
+| 💼 財報行事曆 | fmp-mcp-server | 需 FMP_API_KEY（免費方案可用） |
+| 📈 投資組合管理 | alpaca-mcp-server | 需 ALPACA_API_KEY + SECRET |
 
 ---
 
@@ -274,6 +276,21 @@
       "command": "python",
       "args": ["<YOUR_PATH>/mcp-optionsflow/optionsflow.py"]
     },
+    "alpaca": {
+      "command": "uvx",
+      "args": ["alpaca-mcp-server"],
+      "env": {
+        "ALPACA_API_KEY": "${ALPACA_API_KEY}",
+        "ALPACA_API_SECRET": "${ALPACA_API_SECRET}"
+      }
+    },
+    "fmp": {
+      "command": "uvx",
+      "args": ["fmp-mcp-server"],
+      "env": {
+        "FMP_API_KEY": "${FMP_API_KEY}"
+      }
+    },
     "openecon-data": {
       "type": "sse",
       "url": "https://data.openecon.ai/mcp"
@@ -282,6 +299,8 @@
 }
 ```
 
+> 注意：`.mcp.json` 已進 repo，使用 `${VAR}` 佔位符。實際部署時需在環境中設定對應 env var。
+
 ---
 
 ## 安裝前置作業清單
@@ -292,8 +311,10 @@
 | 確認 Node.js ≥ 18 | `node --version` | 待確認 |
 | clone mcp-optionsflow | `git clone https://github.com/twolven/mcp-optionsflow.git` + `pip install -r requirements.txt` | 待執行 |
 | 申請 Fugle API key | https://developer.fugle.tw/docs/key | 待申請 |
-| 填入 FRED API key | 填入 `YOUR_FRED_API_KEY` 至 .mcp.json | 待執行 |
+| 申請 FRED API key | https://fred.stlouisfed.org/docs/api/api_key.html | 待申請 |
-| 建立 `.mcp.json` | 放入 KingClawArmy/ 根目錄 | 待執行 |
+| 申請 FMP API key | https://financialmodelingprep.com/developer/docs | 待申請 |
+| 申請 Alpaca API key | https://alpaca.markets | 待申請（portfolio-manager 才需要） |
+| 設定環境變數 | 填入各 `${VAR}` 對應的真實值 | 待執行 |
 | 設定 Claude Code 權限 | `{"enableAllProjectMcpServers": true}` | 待執行 |
 
 ---