ai-poker-wizard

Use when analyzing poker hands, tournament decisions, or GTO strategy questions. Triggers on poker terminology (bb, SB, UTG, all-in, ranges, equity) or requests for hand analysis, strategy advice, or tournament coaching.

Use when deploying AI Poker Wizard bot to production, updating the running container, or troubleshooting deployment issues. Triggers on "deploy", "部署", "上線", "restart bot", "重啟".

Use when user reports any hand analysis error — OCR misparse, wrong GTO output, bad action matching, missing solver data, formatting bugs. Triggers on hand ID + correction like "H2507 是 KdQs 才對", "H2506 check-raise 沒有 solver 數據". Automates debug → fix → test cycle.

Attach agent-browser to a live, authenticated GTO Wizard web session over CDP so scripts can pull Analyze/Trainer/report data straight from the SPA's own API. Use when you need to read data out of app.gtowizard.com through the browser (hands table, hand detail, correctness/score reports, practiced hands) or to repair an expired/FORCED_LOGOUT token from a fresh manual login. Triggers: "開 gtow 瀏覽器抓資料", "connect to gto wizard session", "gtow cdp", "attach agent-browser to gtowizard", "pull analyze hands".

Refresh the owner's GTO Wizard DB token after expiry/FORCED_LOGOUT. Use for "更新 GTO token", "refresh gto token", "GTO Wizard 過期", or login tasks.

Deprecated alias for syncing the owner's current GTO Wizard browser token into users.gto_refresh_token. No local token file is created.

Use when the Chrome extension (chrome-extension/) changed and needs to ship — packaging a new build and publishing it as a GitHub release for users to download or reload. Triggers on "發 extension release", "extension 新版本", "publish extension", "package extension", "ext-v", "extension release", "更新 extension".

Navigate the GTO Wizard SPA over a live CDP session and build precise GTOW Trainer drill deep-links. Use when you need to (a) reverse-engineer what URL params a GTOW page uses, (b) drive the Practice/Trainer UI from the terminal, or (c) construct a `/practice/trainer?...` deep-link that lands the player on an exact spot (position + action + IP/OOP + street). Triggers: "gtow trainer 參數", "drill 連結", "how does the trainer URL encode X", "reverse engineer gtow drill", "build a precise practice link".

Use to turn rules-validator detections into parser/OCR fixes — "close the loop" on parse quality. Triggers on "validation backlog", "validator findings", "哪些手牌解析有問題", "改進辨識 pipeline", "which parses are broken", "fix the weakest parser". Runs scripts/validation_report.py, picks the weakest parser by failure mode × source, then drives the confirm → fix → lock loop.

Use to MEASURE OCR hero-card / parse accuracy against the 7k pokercraft ground-truth corpus — establishing a baseline, iterating on hero/board localization or CardCNN changes, or quantifying a fix's before/after. Triggers on "benchmark the OCR", "run the OCR benchmark", "hero localization accuracy", "train/test eval", "how accurate is the parse", "did this change help/hurt OCR". For the hard pre-commit no-regression GATE, use verify-ocr-no-regression instead.

Use when you have changed any OCR / card-recognition pipeline logic in scripts/ocr/** (table_parser, panel_parser, n8_parser, region_detector, the CardCNN classifier, repair rules, confidence thresholds) or the card model — before committing, merging, or claiming the change is done. Triggers whenever a diff touches how images become hand JSON.

End-to-end workflow for harvesting a benchmark-grade hand corpus from my.pokercraft.com — bulk Hand-History download, per-hand replay-image scrape, ground-truth derivation, and the title-OCR integrity loop that catches silent label corruption. Use when building, extending, or repairing the OCR ground-truth dataset, or when reviving the scraper after a session expiry. Triggers on phrases like "爬 PokerCraft", "更新 hand history corpus", "重跑 ground truth", "OCR dataset 校驗", "scrape replay images".

Query the Supabase database (read-only). Use when checking users, hand histories, cache entries, or any DB data. Triggers on "query db", "check db", "查資料庫", "DB 有什麼", "有幾個用戶".