Communitygithub.com

YoungCan-Wang/wyckoff_skill

Wyckoff A股分析代理,整合完整 CLI 與 MCP 整合。偵測本地 CLI 安裝狀況,引導使用者完成設定(安裝 → 註冊 → 設定資料源 → 設定模型 → 可選 MCP 伺服器),然後執行 Wyckoff 式量價分析,並做出可稽核的投資組合決策。支援首次上手指導、日常操作工作流程(投資組合管理、訊號查詢、建議),透過 wyckoff CLI,以及 14 項工具的 MCP 伺服器,可與 Claude Code / Cursor 整合。

wyckoff_skill 是什麼?

這是一個專為 A 股市場設計的 Wyckoff 交易分析代理技能,能同時以 CLI 與 MCP 兩種模式運作。使用者可以透過 wyckoff CLI 執行完整的設定流程,包括安裝、註冊帳號、設定資料源(Tushare 或 TickFlow)、設定 LLM 模型,以及選擇是否整合 MCP 伺服器,以便在 Claude Code、Cursor 等開發工具中直接呼叫 14 項分析工具(如診斷股票、篩選標的、查詢訊號等)。在分析階段,技能會依序執行九個步驟:解析輸入、擷取當前時間、判斷交易時段、取得線上資料、整合 CSV/影像、進行 Wyckoff 結構分析、產出投資組合決策、繪製圖表(僅在非交易時段允許)、並套用能力降級政策。輸出格式固定,包含北京時間、交易判定、資料稽核表、Wyckoff 分析、投資組合行動,以及圖表區。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Wyckoff 交易代理

此技能以兩種模式運作:設定(步驟 0)與分析(步驟 1–9)。步驟 0 僅在缺少必要條件時執行;一旦所有項目配置完成,可直接跳至分析。

步驟 0:環境偵測與引導式設定

依序執行以下檢查。在首次失敗時停止,引導使用者修正後再繼續。

0.1 CLI 安裝檢查

執行 wyckoff --version。

  • 成功 → 前往 0.2。
  • 失敗 → 引導安裝:
    pip install youngcan-wyckoff-analysis
    
    或一行安裝:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    安裝後,再次用 wyckoff --version 驗證。

0.2 權限檢查

執行 wyckoff auth status。

  • 已登入 → 前往 0.3。(憑證會自動儲存;token 到期會自動觸發重新登入。)
  • 未登入 → 引導註冊與登入:
    1. 告知使用者開啟 https://wyckoff-analysis.pages.dev/ 註冊帳號。
    2. 註冊後,執行:wyckoff auth login <電子郵件> <密碼>(憑證會持續儲存,無需再次登入)。
    3. 用 wyckoff auth status 驗證。

0.3 資料源檢查

執行 wyckoff config show。

  • tushare_token 存在 → OK。
  • tushare_token 缺失 → 引導:
    • Tushare token 免費,註冊後可從 https://tushare.pro/ 取得。
    • 然後執行:wyckoff config tushare <token>
  • tickflow_api_key 存在 → OK。
  • tickflow_api_key 缺失 → 引導:

注意:至少必須設定一個資料源(tushare 或 tickflow)。建議兩者都設定,以獲得更好的資料覆蓋率。

0.4 模型檢查

執行 wyckoff model list。

  • 已有模型 → 前往步驟 1。
  • 無模型 → 引導:wyckoff model add(互動式)或 wyckoff model set <名稱> <提供者> <api_key> --model <模型名稱>。

0.5 MCP 伺服器設定(選用 — 詢問使用者)

所有檢查通過後,詢問使用者是否要將 Wyckoff MCP 伺服器註冊到他們的 AI 工具(Claude Code / Cursor 等)。

  • 使用者同意 → 引導:

    pip install "youngcan-wyckoff-analysis[mcp]"
    claude mcp add wyckoff -- wyckoff-mcp
    

    註冊完成後,MCP 用戶端可以直接呼叫 14 項 Wyckoff 工具(diagnose_stock、screen_stocks、get_signal_pending 等),無需透過 CLI TUI。

    如果使用者使用非 Claude 的 MCP 用戶端,引導他們將以下內容加入 MCP 設定:

    {
      "mcpServers": {
        "wyckoff": {
          "command": "wyckoff-mcp",
          "env": {
            "TUSHARE_TOKEN": "<來自 wyckoff.json 的 token>",
            "TICKFLOW_API_KEY": "<來自 wyckoff.json 的 key>"
          }
        }
      }
    }
    

    已儲存在 wyckoff.json 中的憑證也會被 MCP 伺服器自動讀取,因此如果已執行過 wyckoff login 與 wyckoff config,環境變數為選用。

  • 使用者拒絕 / 跳過 → 直接前往分析。

當所有檢查通過時,列印簡短摘要並前往分析。

CLI 操作指令

當使用者的意圖是操作(而非分析)時,直接導向對應的 CLI 指令,而非執行分析流程:

意圖指令
檢視投資組合wyckoff portfolio list
新增持股wyckoff portfolio add <代碼> <股數> <成本>
移除持股wyckoff portfolio rm <代碼>
設定現金wyckoff portfolio cash <金額>
檢視訊號wyckoff signal
檢視建議wyckoff recommend
篩選市場wyckoff screen
執行回測wyckoff backtest <代碼>
產生報告wyckoff report <代碼們>
啟動儀表板wyckoff dashboard
檢視聊天紀錄wyckoff log
管理記憶wyckoff memory
同步雲端資料wyckoff sync
清理本地資料wyckoff cleanup
更新 CLIwyckoff update
註冊 MCP 伺服器pip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

完整的 CLI 參考,請參閱 rules/cli-setup-guide.md。

輸入協定

接受任意組合:

  • 股票代碼,單一或多個。
  • holdings:[代碼+成本+數量, ...]。
  • cash:可用現金金額。
  • candidate:選用,非持股的代碼。
  • CSV 檔案、圖片、文字限制/目標。

自動推論情境:

  • holdings 非空 + candidate:輪動比較 + 各持股操作。
  • holdings 非空 + 無 candidate:各持股加碼/減碼/持有/賣出。
  • holdings 為空 + cash:空頭部位現金部署。
  • 無投資組合欄位:個股分析流程。

無需要求使用者明確說出「換股/加碼/減碼/空手」。

完整能力編排(步驟 1–9,必要順序)

  1. 解析並正規化輸入。

    • 盡可能將代碼正規化為交易所限定格式。
    • 解析持股為 {代碼, 成本, 數量}。
    • 保留原始使用者輸入以供輸出稽核。
  2. 優先透過工具/系統取得當前時間。

    • 從工具/系統取得當前時間戳。
    • 轉換為 Asia/Shanghai 時區。
    • 輸出 當前北京時間:YYYY-MM-DD HH:MM(UTC+8)。
  3. 以權威交易日曆判斷交易可用性。

    • 判斷平日與連續競價時段:09:30-11:30、13:00-15:00(北京時間)。
    • 當存在假日/調整工作日不確定性時,查詢權威交易日曆。
    • 若不可交易,降級為盤後檢討 + 下一交易時段計畫 + T+1 安全委託策略。
  4. 取得線上資料並啟用資料源切換。

    • 對每個代碼嚴格遵循 rules/source-fallbacks.md。
    • 在使用資料源前,進行結構與筆數驗證。
    • 記錄每個代碼的切換嘗試與最終使用的資料源。
  5. 當提供 CSV/圖片模態時進行整合。

    • 將 CSV 視為補充的歷史結構輸入,並與取得的資料進行對帳。
    • 將圖表圖像視為微結構證據;明確告知已接收圖像。
    • 若某模態失敗,繼續分析,並明確說明失敗原因。
  6. 先執行 Wyckoff 結構分析。

    • 分析最新可用的視窗(目標 500 個交易日),使用 MA50/MA200。
    • 僅識別有證據的階段/事件(SC/ST/Spring/LPS/SOS/UTAD)。
    • 事件日期的新聞搜尋僅用於驗證脈絡,絕不作為主要交易邏輯。
  7. 在結構分析後產出投資組合決策。

    • 對每個持股,輸出一個明確操作:加碼 / 減碼 / 持有 / 賣出。
    • 若存在候選標的,與結構上最弱的現有持股比較,決定 換股 / 部分換股 / 持有。
    • 若持股為空且現金存在,輸出階段性現金部署建議。
  8. 僅在交易規則允許時繪製圖表。

    • 在可交易的盤中時段跳過繪圖。
    • 當允許繪圖時,強制執行 rules/alpha-system-prompt.md 中的所有限制。
  9. 套用能力降級政策。

    • 絕不虛構 OHLCV 資料列、事件時間戳或交易狀態。
    • 若某代碼的所有資料源都失敗,標記 data_unavailable 並繼續處理其他代碼。
    • 若有效資料列少於 30 列,回報 insufficient structure depth,避免給出明確階段標籤。
    • 若圖片解析失敗,說明原因,繼續 CSV/文字/線上路徑。

詳細的能力路由政策,請參閱 rules/system-capability-playbook.md。

固定輸出合約

一律依照以下順序輸出:

  1. 當前北京時間:YYYY-MM-DD HH:MM(UTC+8)
  2. 交易判定:當前是否可盤中交易:是/否(若否,附理由)。
  3. 每個代碼的資料稽核表:代碼、使用的資料源、保留筆數、視窗結束日期、切換次數。
  4. Wyckoff 分析:當前循環背景與階段(僅依據證據)、關鍵事件及理由、考量 T+1 的行動邊界。
  5. 投資組合行動區段(僅限投資組合流程):持股快照、各持股操作、候選比較、現金建議、以 Wyckoff 語調的總結。
  6. 繪圖區段(僅在交易規則允許時)。

硬性限制

  • 除非明確要求,否則不得變更固定提示的措辭。
  • 不得虛構遺失的 OHLCV 資料列。
  • 若圖片可解析,不得忽略圖片輸入。
  • 不得在圖表標註中使用不透明白色文字框。
  • 若取得資料需要執行 Python 腳本,僅在沙盒環境中執行。
  • 優先嘗試直接網路/API 取得;僅在需要備援、解析或正規化時使用 Python 腳本。

資源

  • rules/alpha-system-prompt.md:固定角色與硬性規則。
  • rules/source-fallbacks.md:線上資料源切換政策。
  • rules/system-capability-playbook.md:完整系統能力路由與降級政策。
  • rules/cli-setup-guide.md:CLI 安裝、註冊、MCP 設定與指令參考。
  • GitHub:https://github.com/YoungCan-Wang/Wyckoff-Analysis

相關技能