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 | bashwyckoff --version驗證。
0.2 權限檢查
執行 wyckoff auth status。
- 已登入 → 前往 0.3。(憑證會自動儲存;token 到期會自動觸發重新登入。)
- 未登入 → 引導註冊與登入:
- 告知使用者開啟 https://wyckoff-analysis.pages.dev/ 註冊帳號。
- 註冊後,執行:
wyckoff auth login <電子郵件> <密碼>(憑證會持續儲存,無需再次登入)。 - 用
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 缺失 → 引導:
- TickFlow 提供即時與歷史 A 股資料。
- 購買網址:https://tickflow.org/auth/register?ref=5N4NKTCPL4
- 然後執行:
wyckoff config 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 |
| 更新 CLI | wyckoff 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,必要順序)
-
解析並正規化輸入。
- 盡可能將代碼正規化為交易所限定格式。
- 解析持股為
{代碼, 成本, 數量}。 - 保留原始使用者輸入以供輸出稽核。
-
優先透過工具/系統取得當前時間。
- 從工具/系統取得當前時間戳。
- 轉換為
Asia/Shanghai時區。 - 輸出
當前北京時間:YYYY-MM-DD HH:MM(UTC+8)。
-
以權威交易日曆判斷交易可用性。
- 判斷平日與連續競價時段:
09:30-11:30、13:00-15:00(北京時間)。 - 當存在假日/調整工作日不確定性時,查詢權威交易日曆。
- 若不可交易,降級為盤後檢討 + 下一交易時段計畫 + T+1 安全委託策略。
- 判斷平日與連續競價時段:
-
取得線上資料並啟用資料源切換。
- 對每個代碼嚴格遵循
rules/source-fallbacks.md。 - 在使用資料源前,進行結構與筆數驗證。
- 記錄每個代碼的切換嘗試與最終使用的資料源。
- 對每個代碼嚴格遵循
-
當提供 CSV/圖片模態時進行整合。
- 將 CSV 視為補充的歷史結構輸入,並與取得的資料進行對帳。
- 將圖表圖像視為微結構證據;明確告知已接收圖像。
- 若某模態失敗,繼續分析,並明確說明失敗原因。
-
先執行 Wyckoff 結構分析。
- 分析最新可用的視窗(目標 500 個交易日),使用
MA50/MA200。 - 僅識別有證據的階段/事件(SC/ST/Spring/LPS/SOS/UTAD)。
- 事件日期的新聞搜尋僅用於驗證脈絡,絕不作為主要交易邏輯。
- 分析最新可用的視窗(目標 500 個交易日),使用
-
在結構分析後產出投資組合決策。
- 對每個持股,輸出一個明確操作:
加碼 / 減碼 / 持有 / 賣出。 - 若存在候選標的,與結構上最弱的現有持股比較,決定
換股 / 部分換股 / 持有。 - 若持股為空且現金存在,輸出階段性現金部署建議。
- 對每個持股,輸出一個明確操作:
-
僅在交易規則允許時繪製圖表。
- 在可交易的盤中時段跳過繪圖。
- 當允許繪圖時,強制執行
rules/alpha-system-prompt.md中的所有限制。
-
套用能力降級政策。
- 絕不虛構 OHLCV 資料列、事件時間戳或交易狀態。
- 若某代碼的所有資料源都失敗,標記
data_unavailable並繼續處理其他代碼。 - 若有效資料列少於 30 列,回報
insufficient structure depth,避免給出明確階段標籤。 - 若圖片解析失敗,說明原因,繼續 CSV/文字/線上路徑。
詳細的能力路由政策,請參閱 rules/system-capability-playbook.md。
固定輸出合約
一律依照以下順序輸出:
當前北京時間:YYYY-MM-DD HH:MM(UTC+8)- 交易判定:
當前是否可盤中交易:是/否(若否,附理由)。 - 每個代碼的資料稽核表:
代碼、使用的資料源、保留筆數、視窗結束日期、切換次數。 - Wyckoff 分析:當前循環背景與階段(僅依據證據)、關鍵事件及理由、考量 T+1 的行動邊界。
- 投資組合行動區段(僅限投資組合流程):持股快照、各持股操作、候選比較、現金建議、以 Wyckoff 語調的總結。
- 繪圖區段(僅在交易規則允許時)。
硬性限制
- 除非明確要求,否則不得變更固定提示的措辭。
- 不得虛構遺失的 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