fix: 修正審查員 P1-P6 全部問題

P1/P2: 為所有 53 個 SKILL.md 補明確 slug frontmatter，解決 importer slug 衝突
P3: 新增 .mcp.json，補 .paperclip.yaml envInputs
P4: agent-skill-mapping.md 補摘要版說明
P5: 修正文檔統計數字（53 skills，非 62）
P6: 清除 mcp-plan.md 敏感資訊與機器相依路徑

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.mcp.json

@@ -0,0 +1,30 @@
+{
+  "mcpServers": {
+    "yahoo-finance": {
+      "command": "uvx",
+      "args": ["yahoo-finance-mcp"]
+    },
+    "fred": {
+      "command": "uvx",
+      "args": ["fred-mcp-server"],
+      "env": {
+        "FRED_API_KEY": "${FRED_API_KEY}"
+      }
+    },
+    "casual-market": {
+      "command": "uvx",
+      "args": ["casual-market-mcp"]
+    },
+    "fugle-marketdata": {
+      "command": "uvx",
+      "args": ["fugle-marketdata-mcp-server"],
+      "env": {
+        "FUGLE_API_KEY": "${FUGLE_API_KEY}"
+      }
+    },
+    "tradingview": {
+      "command": "uvx",
+      "args": ["tradingview-mcp-server"]
+    }
+  }
+}

.paperclip.yaml

@@ -80,6 +80,14 @@ 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

docs/agent-skill-mapping.md

@@ -4,6 +4,7 @@
 > 更新日期：2026-04-10
 > 來源：基於 tradermonty/claude-trading-skills、ginlix-ai/langalpha、anthropics/skills 的調查結果
 > 原則：技能來自真實開源 repo，不自製；台股＋美股雙市場覆蓋
+> 版本說明：目前 SKILL.md 均為摘要參考版（Summary Reference），提供方法論架構與 MCP 需求聲明。完整 reference/ 與 scripts/ 目錄將於後續版本補齊。
 
 ---
 
@@ -23,8 +24,8 @@
 | `ceo` | 執行長 | 5 | tradermonty、anthropics |
 | `xiao-an` | 小安 | 2 | anthropics |
 
-**技能檔案總計：62 個 SKILL.md（全在 skills/ 目錄）**
+**技能檔案總計：53 個 SKILL.md（全在 skills/ 目錄）**
-**技能配置總計：71 個分配（含共用技能跨 Agent 重複引用）**
+**技能配置總計：72 個分配（含共用技能跨 Agent 重複引用）**
 
 ---
 

docs/mcp-plan.md

@@ -138,7 +138,7 @@
 - **GitHub**：https://github.com/stefanoamorelli/fred-mcp-server
 - **工具數**：3 個
 - **需要 key**：是（已取得，見環境設定）
-- **FRED API Key**：`abcdefghijklmnopqrstuvwxyz123456`（需在 .mcp.json 填入）
+- **FRED API Key**：`YOUR_FRED_API_KEY`（需在 .mcp.json 填入）
 - **主要工具**：
   - `fred_browse` — 瀏覽 80 萬+ 經濟數列
   - `fred_search` — 關鍵字搜尋
@@ -149,7 +149,7 @@
   "command": "npx",
   "args": ["-y", "fred-mcp-server"],
   "env": {
-    "FRED_API_KEY": "abcdefghijklmnopqrstuvwxyz123456"
+    "FRED_API_KEY": "YOUR_FRED_API_KEY"
   }
 }
 ```
@@ -192,7 +192,7 @@
 ```json
 "optionsflow": {
   "command": "python",
-  "args": ["/home/chris/workspace/mcp-optionsflow/optionsflow.py"]
+  "args": ["<YOUR_PATH>/mcp-optionsflow/optionsflow.py"]
 }
 ```
 
@@ -259,7 +259,7 @@
       "command": "npx",
       "args": ["-y", "fred-mcp-server"],
       "env": {
-        "FRED_API_KEY": "abcdefghijklmnopqrstuvwxyz123456"
+        "FRED_API_KEY": "YOUR_FRED_API_KEY"
       }
     },
     "tradingview": {
@@ -272,7 +272,7 @@
     },
     "optionsflow": {
       "command": "python",
-      "args": ["/home/chris/workspace/mcp-optionsflow/optionsflow.py"]
+      "args": ["<YOUR_PATH>/mcp-optionsflow/optionsflow.py"]
     },
     "openecon-data": {
       "type": "sse",
@@ -292,7 +292,7 @@
 | 確認 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 | 已取得 `abcdefghijklmnopqrstuvwxyz123456` | ✅ 已取得 |
+| 填入 FRED API key | 填入 `YOUR_FRED_API_KEY` 至 .mcp.json | 待執行 |
 | 建立 `.mcp.json` | 放入 KingClawArmy/ 根目錄 | 待執行 |
 | 設定 Claude Code 權限 | `{"enableAllProjectMcpServers": true}` | 待執行 |
 

skills/backtest-expert/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 回測專家
+slug: backtest-expert
 description: 策略回測專家，支援歷史數據回測、績效指標計算與策略參數最佳化
 metadata:
   sources:

skills/breadth-chart-analyst/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 廣度圖表分析師
+slug: breadth-chart-analyst
 description: 深度分析 S&P 500 廣度指數（200日均線）與漲勢比例圖表，從 CSV 數據和圖表截圖萃取市場健康度結論，約 1200 行的高度詳細技能
 metadata:
   sources:

skills/canslim-screener/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: CANSLIM 選股篩選器
+slug: canslim-screener
 description: William O'Neil 七成分成長股方法論（C-A-N-S-L-I-M），加權評分篩選最強成長股，Phase 3 完整實作
 metadata:
   sources:

skills/catalyst-calendar/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 催化劑行事曆
+slug: catalyst-calendar
 description: 追蹤可能影響股價的即將到來事件與公告，包含產品發布、監管審批、分析師日、投資者日等事件驅動機會
 metadata:
   sources:

skills/competitive-analysis/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 競爭分析
+slug: competitive-analysis
 description: 深度分析產業競爭格局，評估目標公司的競爭優勢、市場份額動態、競爭威脅，供多方（護城河識別）和空方（競爭惡化）使用
 metadata:
   sources:

skills/comps-analysis/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 可比公司分析
+slug: comps-analysis
 description: 相對估值分析（Comparable Company Analysis / Trading Comps），比較目標公司與同業的 EV/EBITDA、P/E、P/S 等倍數，評估相對高估/低估
 metadata:
   sources:

skills/data-quality-checker/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 資料品質檢查器
+slug: data-quality-checker
 description: 驗證金融數據的準確性，包括價格刻度、工具代碼格式、日期連續性、配置合計、單位一致性，防止錯誤數據影響分析
 metadata:
   sources:

skills/dcf-model/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: DCF 估值模型
+slug: dcf-model
 description: 折現現金流（DCF）估值分析，建立完整的三期成長模型，計算內在價值與安全邊際，判斷個股是否低估/高估
 metadata:
   sources:

skills/doc-coauthoring/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 文件共同創作
+slug: doc-coauthoring
 description: 三階段結構化文件起草工作流程（情境蒐集→精煉與結構→讀者測試），適用於策略報告、會議備忘錄、分析備忘錄等長篇文件
 metadata:
   sources:

skills/downtrend-duration-analyzer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 下跌持續時間分析器
+slug: downtrend-duration-analyzer
 description: 歷史下跌持續時間統計分析，按板塊與市值分類，產出互動式直方圖，讓空方研究員量化下跌波段的典型長度
 metadata:
   sources:

skills/earnings-analysis/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 財報後分析
+slug: earnings-analysis
 description: 財報發布後的深度解讀，分析 EPS/營收 vs 預估、管理層指引、財報電話關鍵訊號，評估對後市的影響
 metadata:
   sources:

skills/earnings-calendar/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 財報行事曆
+slug: earnings-calendar
 description: 透過 FMP API 擷取即將發布的美股財報時程，按日期與盤前/盤後排列，讓研究員提前佈局
 metadata:
   sources:

skills/earnings-preview/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 財報預覽分析
+slug: earnings-preview
 description: 財報發布前的預期分析，整合分析師預估、選擇權隱含波動率、歷史財報表現，評估財報的上行/下行風險
 metadata:
   sources:

skills/earnings-trade-analyzer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 財報交易分析器
+slug: earnings-trade-analyzer
 description: 五因子 0-100 評分（跳空幅度、趨勢強度、成交量、MA200、MA50 位置），A/B/C/D 分級，快速評估財報後個股的交易價值
 metadata:
   sources:

skills/economic-calendar-fetcher/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 經濟行事曆擷取器
+slug: economic-calendar-fetcher
 description: 擷取未來 7-90 天經濟事件（FOMC、NFP、CPI/PPI、GDP），含影響評估
 metadata:
   sources:

skills/edge-candidate-agent/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: Edge 候選代理人
+slug: edge-candidate-agent
 description: 將每日市場觀察轉為結構化、可重現的研究票據（Research Ticket），作為 Edge 研究流程的第一步輸入
 metadata:
   sources:

skills/edge-concept-synthesizer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: Edge 概念合成器
+slug: edge-concept-synthesizer
 description: 將多個 Edge 線索票據的證據聚類為可重用的 Edge 概念，每個概念附帶核心論點、否定條件與策略手冊
 metadata:
   sources:

skills/edge-hint-extractor/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: Edge 線索提取器
+slug: edge-hint-extractor
 description: 從每日市場觀察、新聞或研究筆記中提取結構化 Edge 線索，輸出標準 hints.yaml 供下游合成器使用
 metadata:
   sources:

skills/edge-pipeline-orchestrator/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: Edge 流程協調器
+slug: edge-pipeline-orchestrator
 description: 端到端 Edge 研究流程管理（候選→線索→概念→策略→審查），含反饋迴路與斷點續跑，是量化策略師的研究自動化中樞
 metadata:
   sources:

skills/edge-signal-aggregator/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 優勢訊號整合器
+slug: edge-signal-aggregator
 description: 多因子訊號整合器，匯集技術面、基本面、情緒面訊號並計算綜合 Edge 分數
 metadata:
   sources:

skills/edge-strategy-reviewer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 策略審查工具
+slug: edge-strategy-reviewer
 description: 策略審查工具，系統性檢驗策略邏輯、風險盲點、過擬合風險與執行可行性
 metadata:
   sources:

skills/exposure-coach/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 曝險管理教練
+slug: exposure-coach
 description: 部位曝險教練，根據市場環境動態調整建議持倉比例、避險配置與現金水位
 metadata:
   sources:

skills/ftd-detector/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 跟進日偵測器
+slug: ftd-detector
 description: 市場底部確認的跟進日（Follow-Through Day, FTD）偵測，採用雙指數（S&P 500 + NASDAQ）狀態機，避免假訊號
 metadata:
   sources:

skills/initiating-coverage/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 啟動追蹤報告
+slug: initiating-coverage
 description: 生成 30-50 頁機構級股票研究報告（啟動追蹤），涵蓋商業模式、財務分析、估值模型、風險評估與投資建議
 metadata:
   sources:

skills/institutional-flow-tracker/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 法人資金流向追蹤器
+slug: institutional-flow-tracker
 description: 追蹤法人資金流向，涵蓋 13F 持倉、ETF 資金流、暗池交易與大戶動向
 metadata:
   sources:

skills/internal-comms/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 內部溝通
+slug: internal-comms
 description: 撰寫內部溝通文件，包含狀態更新、3P（進度/計畫/問題）報告、事件報告、FAQ、每週通訊等格式
 metadata:
   sources:

skills/macro-regime-detector/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 總經環境偵測器
+slug: macro-regime-detector
 description: 六成分跨資產比率分析（RSP/SPY、殖利率曲線、HYG/LQD、IWM/SPY、SPY/TLT、XLY/XLP），將市場分類為5種環境，指導曝險決策
 metadata:
   sources:

skills/market-breadth-analyzer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 市場廣度分析器
+slug: market-breadth-analyzer
 description: 市場廣度分析，追蹤漲跌家數比、新高新低比、成交量分佈等內部結構指標
 metadata:
   sources:

skills/market-environment-analysis/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 總體市場環境分析
+slug: market-environment-analysis
 description: 總體市場環境分析，涵蓋股市、外匯、商品、殖利率、情緒指標的結構化報告
 metadata:
   sources:

skills/market-news-analyst/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 市場新聞分析師
+slug: market-news-analyst
 description: 蒐集過去 10 天市場新聞，分析 FOMC、財報、地緣政治等事件的市場影響並評分
 metadata:
   sources:

skills/market-top-detector/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 市場頂部偵測器
+slug: market-top-detector
 description: 市場頂部偵測，綜合技術面背離、資金面轉弱、情緒面過熱的多維度警示系統
 metadata:
   sources:

skills/morning-note/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 盤前晨報
+slug: morning-note
 description: 每日盤前市場摘要，整合美股收盤、亞股動態、台股盤前、重要數據、今日關注事件，含視覺化圖表
 metadata:
   sources:

skills/options-strategy-advisor/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 選擇權策略顧問
+slug: options-strategy-advisor
 description: Black-Scholes 定價、Greeks 計算、17+ 選擇權策略的損益模擬（價差、禿鷹、財報策略等），約 1200 行的完整選擇權分析技能
 metadata:
   sources:

skills/pair-trade-screener/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 配對交易篩選器
+slug: pair-trade-screener
 description: 統計套利技能，執行共整合檢定、計算利差 Z 值，產出市場中性配對交易的進出場建議，約 1100 行的量化套利技能
 metadata:
   sources:

skills/pead-screener/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: PEAD 篩選器
+slug: pead-screener
 description: 財報後公告漂移（Post-Earnings Announcement Drift）篩選，自動識別財報跳空後的回調買點與突破訊號
 metadata:
   sources:

skills/portfolio-manager/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 投資組合管理員
+slug: portfolio-manager
 description: 透過 Alpaca MCP 分析投資組合配置、風險指標、再平衡建議、稅損採收機會與股息分析，約 1100 行的完整投資組合管理技能
 metadata:
   sources:

skills/position-sizer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 部位規模計算器
+slug: position-sizer
 description: 部位規模計算器，基於風險預算、波動率與凱利公式計算最適部位大小
 metadata:
   sources:

skills/scenario-analyzer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 情境分析引擎
+slug: scenario-analyzer
 description: 情境分析引擎，建構牛熊中性多重情境，量化各情境機率與預期報酬
 metadata:
   sources:

skills/sector-analyst/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 板塊輪動分析師
+slug: sector-analyst
 description: 從 CSV 數據分析美股十一大板塊的輪動模式與市場週期定位，識別強勢/弱勢板塊
 metadata:
   sources:

skills/sector-overview/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 板塊概況分析
+slug: sector-overview
 description: 產出特定板塊的全面概況報告，涵蓋板塊基本面趨勢、主要催化劑、龍頭股表現、估值水平與相對強弱
 metadata:
   sources:

skills/signal-postmortem/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 訊號事後分析
+slug: signal-postmortem
 description: 訊號事後分析，回顧歷史訊號準確率、獲利因子分解與策略衰退偵測
 metadata:
   sources:

skills/stanley-druckenmiller-investment/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: Druckenmiller 策略合成器
+slug: stanley-druckenmiller-investment
 description: 整合 8 個上游技能輸出，以 Stanley Druckenmiller 的宏觀投資方法論產出統一信心評分（0-100）、型態分類與倉位配置建議
 metadata:
   sources:

skills/strategy-pivot-designer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 策略轉向設計師
+slug: strategy-pivot-designer
 description: 偵測回測策略停滯或陷入局部最優，自動提出結構性不同的策略轉向方案，突破策略開發瓶頸
 metadata:
   sources:

skills/technical-analyst/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 技術分析師
+slug: technical-analyst
 description: 技術分析工具，支援均線、RSI、MACD、布林通道等指標運算與圖表判讀
 metadata:
   sources:

skills/theme-detector/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 市場主題偵測器
+slug: theme-detector
 description: 偵測當前市場的趨勢主題（AI、能源轉型、利率等），評估各主題的熱度、生命週期階段與信心評分
 metadata:
   sources:

skills/thesis-tracker/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 投資論點追蹤器
+slug: thesis-tracker
 description: 長期追蹤投資論點的進展，監控關鍵假設是否仍然成立，在論點失效時自動預警
 metadata:
   sources:

skills/trade-hypothesis-ideator/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 交易假設發想器
+slug: trade-hypothesis-ideator
 description: 生成 1-5 個可偽證的交易假設卡，每張包含實驗設計、否定條件（Kill Criteria）與可選的 strategy.yaml 匯出
 metadata:
   sources:

skills/trader-memory-core/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 交易員記憶核心
+slug: trader-memory-core
 description: 持久化論點生命週期管理，追蹤從想法到平倉的完整交易記錄（IDEA→ENTRY_READY→ACTIVE→CLOSED），含 P&L、MAE/MFE 與事後分析
 metadata:
   sources:

skills/uptrend-analyzer/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 漲勢分析器
+slug: uptrend-analyzer
 description: 五成分 0-100 漲勢健康度綜合評分（廣度30%、板塊參與25%、動量20%、輪動15%、歷史10%），判斷多頭趨勢強度
 metadata:
   sources:

skills/us-market-bubble-detector/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 美股泡沫偵測器
+slug: us-market-bubble-detector
 description: 美股泡沫偵測，分析估值偏離、槓桿水位、散戶狂熱指標與歷史泡沫比對
 metadata:
   sources:

skills/us-stock-analysis/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: 美股個股分析
+slug: us-stock-analysis
 description: 美股個股深度分析，涵蓋基本面、財報、估值模型與產業比較
 metadata:
   sources:

skills/vcp-screener/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: VCP 篩選器
+slug: vcp-screener
 description: Minervini 的波動收縮型態（Volatility Contraction Pattern）偵測，在第 2 階段上升趨勢中識別低風險進場點
 metadata:
   sources:

skills/xlsx/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: Excel 試算表
+slug: xlsx
 description: 建立、編輯、分析符合金融建模標準的 Excel 試算表，含色碼規範（藍色=輸入、黑色=公式）、財務格式化與績效分析
 metadata:
   sources: