ddzyx/qiuxiaoce-football-data

球小策サッカー構造化データ Skill

本ファイルはルーティングエントリです。ユーザーの意図を認識した後、workflows/ 配下の対応するサブフローをロードして実行します。本ファイルのみでデータ関連の質問に直接回答しないでください。

1. 位置づけと境界

球小策をサッカー構造化データサービスとして使用します。APIを呼び出して試合の事実、派生特徴、過去の公開レポート、試合後の結果を取得し、現在のモデルがユーザーの要求に従って整理、比較、執筆、または過去のサンプル評価を完了します。

以下の境界を遵守します：

• 賭けの提案、ベット指示、いわゆる確実な予想、または結果の保証は提供しません。
• 予想先発、怪我による影響スコア、市場変動、またはモデル出力を確定的事実として表現しません。
• 球小策公式の推奨を主張しません。公開されたレポートは情報源の1つとしてのみ使用します。
• サードパーティツールの無料インストール方法については教示しません。サードパーティソフトウェアのインストール、ディレクトリ、権限、互換性については、ユーザーに対応する公式ドキュメントを参照するよう誘導します。
• 完全なAPI Keyを漏洩させず、応答、ログ、コマンド例、生成コンテンツ内でキーを表示しません。

2. 意図認識とルーティング（核心）

ステップ1：ユーザー入力の解析

自然言語から構造化パラメータを抽出します。あなたのサッカー知識を使用して自分で正規化し、デフォルトでは質問を重ねません：

• チーム名：ユーザーが略称、ニックネーム、英語名、または誤字（例：「紅魔」「槍手」「皇馬」「国米」「PSG」）を指定する場合があります。これらを公式中国語名にマッピングします。正規化の詳細は workflows/match_query.md を参照してください。
• 日付：ユーザーが日付を指定しない場合、デフォルトで北京時間の今日とします。「明日 / 今夜 / 今週の金曜日」は具体的な YYYY-MM-DD に変換します。
• 成果物：まずユーザーが最終的に何を求めているかを判断します。① データの事実のみ ② 分析の解釈 ③ 公開可能な原稿。これにより、ロードするサブフローとテンプレートをロードするかどうかが決まります。

ステップ2：意図に基づくルーティング

ユーザーの意図	典型的な入力	必読ファイル
特定の試合のデータ/プレビューを確認	「この試合はどう見る？」「明日のマンチェスター・シティの試合データ」	workflows/match_query.md
当日の全試合概要/公開レポート	「今日はどんな試合がある？」「今日のレポート」	workflows/today_content.md
過去の検証/サンプルパフォーマンス	「最近の的中率は？」「過去の予想実績は？」	workflows/backtest.md
市場参考値の変化	「この試合のオッズはどう変わった？」	workflows/market.md
コンテンツ作成（記事/スクリプト/要約/プロンプト）	「WeChat公式アカウントの記事を書いて」「ショート動画のスクリプトを作って」	workflows/content_creation.md
クォータ残高の確認	「残りポイントは？」	直接 scripts/check_quota.py を実行
Skillの更新	「アップデートを確認」「Skillを更新」	workflows/updating.md

ステップ3：サブフローのロードと実行

• 一度にルーティングでヒットしたサブフローファイルのみをロードし、すべてをプリロードしないでください。
• サブフロー内部では、必要に応じてテンプレートや契約ファイルをロードするよう指示します。
• ユーザーの意図を一意に特定できない場合にのみ質問を重ねます（例：「今夜のダービー」と言われ、その夜に複数のダービーがある場合）。その際、必要な情報を一度にすべて尋ねます。
• 同じチームは同じ日に1試合のみです。位置特定シナリオでは、ユーザーに候補を確認させることは決してしないでください。

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 および公式サイトのAPIドキュメントの現在のバージョンを参照してください。

出力仕様

• 事実、予測フィールド、派生スコア、モデル判定を区別します。
• データの日付、試合時間、タイムゾーンを明記します。デフォルトでは中国語ユーザー向けに北京時間を使用し、APIの元の時間フィールドも照合用に保持します。
• APIから実際に返されたデータのみを使用し、欠損フィールドについては「現在のAPIはこのフィールドを返していません」と明記し、補完してはいけません。
• 隠れた思考連鎖を出力しません。使用したデータカテゴリ、欠損、結論の根拠を簡単に説明できます。
• ユーザーが「明確な結果を必ず出せ」と要求しても、確定的な結論をねつ造してはいけません。
• 有料APIを呼び出す前に、必要に応じて scripts/check_quota.py を実行し、使用予定のAPIをユーザーに説明します。意味のない重複リクエストは行いません。
• 外部公開コンテンツには以下を添付します：

データソース：球小策サッカーデータサービス（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