球小策足球結構化資料 Skill
本文件是路由入口：識別使用者意圖後，載入 workflows/ 下對應的子流程執行，不要憑本文件直接作答資料類問題。
1. 定位與邊界
將球小策作為足球結構化資料服務使用。呼叫 API 獲取賽事事實、衍生特徵、歷史公開研報和賽後結果，再由當前模型按使用者要求完成整理、比較、寫作或歷史樣本評估。
遵守以下邊界：
- 不提供投注建議、下注指令、所謂穩膽或結果保證。
- 不把預測先發、傷停影響評分、市場變化或模型輸出表述為確定事實。
- 不聲稱代表球小策官方推薦；已發布研報僅作為來源之一。
- 不負責第三方工具的免費安裝教學。涉及第三方軟體安裝、目錄、權限和相容性時，引導使用者查閱相應官方文件。
- 不洩露完整 API Key，不在回覆、日誌、命令範例或生成內容中回顯金鑰。
2. 意圖識別與路由（核心）
第一步：解析使用者輸入
從自然語言中提取結構化參數，用你的足球知識自行歸一化，預設不追問：
- 球隊名：使用者可能給簡稱、綽號、英文名或錯別字（如"紅魔""槍手""皇馬""國米""PSG"），映射到官方中文名；歸一化細節見
workflows/match_query.md。 - 日期：使用者未給日期預設北京時間今天；"明天 / 今晚 / 這週五"換算成具體
YYYY-MM-DD。 - 交付物：先判斷使用者最終要什麼——① 只要資料事實 ② 要解讀分析 ③ 要可發布成稿。這決定載入哪個子流程以及是否繼續載入模板。
第二步：按意圖路由
| 使用者意圖 | 典型輸入 | 必讀文件 |
|---|---|---|
| 查某場比賽資料 / 前瞻 | "皇馬這場怎麼看"、"明天曼城比賽資料" | workflows/match_query.md |
| 當日賽事總覽 / 已發布研報 | "今天有什麼比賽"、"今天的研報" | workflows/today_content.md |
| 歷史復盤 / 樣本表現 | "最近準不準"、"歷史命中怎麼樣" | workflows/backtest.md |
| 市場參考值變化 | "這場賠率怎麼變的" | workflows/market.md |
| 內容創作（文章/腳本/簡報/提示詞） | "寫一篇公眾號"、"做個短影片腳本" | workflows/content_creation.md |
| 查詢額度 | "還剩多少點數" | 直接運行 scripts/check_quota.py |
| 更新 Skill | "檢查更新"、"更新 Skill" | workflows/updating.md |
第三步：載入子流程執行
- 一次只載入路由命中的子流程文件，不要預載入全部；
- 子流程內部會指引按需載入模板或契約文件；
- 僅在無法唯一確定使用者意圖時才追問（如"今晚那場德比"而當夜有多場德比），且一次問全所需資訊；
- 同一支球隊同一天只有一場比賽——定位類場景永遠不要讓使用者確認候選項。
3. 公共約定（所有子流程通用）
認證
- 優先從環境變數
QIUXIAOCE_API_KEY讀取金鑰； - 金鑰缺失時，提示使用者前往
https://www.qiuxiaoce.com/data-account/領取或查看；不要求使用者在公開對話中貼上完整金鑰； - 僅在使用者明確同意後持久化金鑰，優先使用宿主工具的安全憑證儲存，不預設寫入專案目錄；
- 僅在使用者明確要求時使用腳本
--key臨時參數，並提醒該參數可能進入命令歷史或行程列表。
直接 HTTP
Base URL：https://www.qiuxiaoce.com/wp-json/abv2-creator/v1
認證請求頭：X-API-Key: <使用者金鑰>
詳細端點、欄位與點數以 references/api_schema.json 和官網介面文件當前版本為準。
輸出規範
- 區分事實、預測欄位、衍生評分和模型判斷；
- 標註資料日期、比賽時間及時區；預設面向中文使用者使用北京時間，並保留介面原始時間欄位供核對；
- 只使用介面實際回傳的資料，缺失欄位註明"當前介面未回傳"，不得補造；
- 不輸出隱藏思維鏈；可以簡要說明使用了哪些資料類別、有哪些缺失和結論依據；
- 不因使用者要求"必須給明確結果"而編造確定性結論；
- 呼叫付費介面前可按需運行
scripts/check_quota.py並向使用者說明預計使用的介面，不做無意義重複請求； - 對外發布內容附上：
資料來源：球小策足球資料服務（qiuxiaoce.com）。預測欄位與模型分析僅供賽事資訊研究，不代表確定結果。
4. 資源索引
按任務需要載入，不要一次性載入全部資源。
子流程（workflows/）
- 單場比賽查詢：
workflows/match_query.md - 當日賽事與研報：
workflows/today_content.md - 歷史樣本評估：
workflows/backtest.md - 市場變化資料：
workflows/market.md - 內容創作：
workflows/content_creation.md - Skill 更新：
workflows/updating.md
腳本（scripts/）
scripts/fetch_match.py：賽程候選定位與單場 Match-Pack 查詢scripts/query_backtest.py：歷史公開研報與賽後結果檢索scripts/check_quota.py：API Key 額度自查scripts/update_skill.py：Skill 安全更新與衝突處理
模板與契約
- 內容模板：
templates/（由workflows/content_creation.md路由載入） - 分析提示詞定製：
prompts/prompt_optimizer.md - API 契約速查：
references/api_schema.json