mcpField
X
xauusd-calendar-descriptions

xauusd-calendar-descriptions

github.com/yiyousiow000814その他036 回インストール15 週間前に更新
リポジトリ

xauusd-calendar-descriptions について

世界の経済カレンダーのイベントを調査し、簡潔な説明を作成するスキルです。XAUUSDへの影響は関連する場合に限って補足し、イベントごとの出典確認と品質チェックを求めます。

主な機能

  1. 01イベントごとの根拠確認
  2. 02公式情報源を優先
  3. 03一〜二文でイベントを定義
  4. 04関連時に条件付きでXAUUSDへの影響を追加
  5. 05調査記録と検証手順
  6. 06表現と文数のチェック

活用シーン

  1. 01根拠付きのカレンダーイベント説明の作成
  2. 02イベントがXAUUSDに影響する可能性の評価
  3. 03公式サイトへのコマンドラインアクセスが阻まれる場合の指標調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yiyousiow000814/xauusd-calendar-agent --skill xauusd-calendar-descriptions

インストール後、Claude Code で/xauusd-calendar-descriptionsを入力して読み込まれたか確認します。

詳細

SKILL.md - XAUUSD 経済カレンダーの説明（グローバル、読みやすさ重視、調査優先）

目標

グローバルなカレンダーの経済指標イベントについて、簡潔で読みやすい説明を作成します。XAUUSD との関連性がある場合に限り、影響に関する補足を任意で加えます。

対象範囲

  • カレンダーにはすべての国・地域が含まれます。
  • 対象資産は XAUUSD です。
  • 出力：イベントごとに1～2文。

出力ルール

  1. 2文以内にします。
  2. 1文目（必須）：イベントが何を測定または決定するかを、正確な測定用語を使って定義します。
    • 金利、政策決定、指数、ディフュージョン・インデックス、週間数値、変化率（％）、収支、声明、議事録、入札
  3. 2文目（任意）：主要な価格決定経路を通じてXAUUSDに影響を及ぼす可能性が十分にある場合に限り、補足を加えます。

調査優先の要件（コピー＆ペーストのような説明を防止）

個別のイベントについて確認せずに、一般的な説明（たとえば、「CPIはインフレを測定します」）を複数のイベントで使い回してはいけません。

イベントごとの最低基準：

  1. その国・発行主体の該当指標や決定について説明している、信頼できる情報源を少なくとも1つ見つけます。
  2. 裏付けとなる短い抜粋を1つ抽出します（1行で十分です）。
  3. その後に限り、自然な英語で1～2文の説明を作成します。

情報源の優先順位：

  1. 公式の発表元（中央銀行、統計局、省庁、取引所、財務省、機関）。
  2. 当該指標に関する公式プレスリリース、PDF、ウェブページ。
  3. 公式情報源へのアクセスが難しい場合は、信頼できる金融カレンダーや大手報道機関を代替として利用します。

テンプレート説明を使わずに効率化（キャッシュ＋公式「ハブ」ページ）

目標：イベントごとの根拠を確認する基準を維持しながら、ウェブ検索の繰り返しを減らし、トークン使用量を最小限に抑えます。

原則：

  1. イベントごとに、固有の裏付けとなる抜粋（1行）と最終的な説明が必要です。
  2. 効率化は、公式情報源の再利用によって実現します（文面の使い回しではありません）。

クォータに配慮したモード（エージェントなし）

クォータの制約で複数のエージェントを使えない場合でも、一般的なテンプレート説明に切り替えてはいけません。 イベントごとの根拠確認基準を維持し、次の方法で調査を効率化します。

  1. ヘルパースクリプトを使って候補となるページを検索し、キャッシュします（tmp/sources/）。
  2. site:を使って検索対象を公式ドメインに限定します（例：site:bls.gov、site:bea.gov、site:census.gov）。
  3. 関連するバリエーション（水準、前月比、前年同月比）について、キャッシュした公式の「ハブ」ページを再利用しつつ、イベントごとの説明は個別に作成します。

このリポジトリの正確なワークフロー（このリポジトリでの「適切な作業」）

このリポジトリでこのスキルに従う場合、期待されるワークフローは次のとおりです。

  1. 作業対象のイベントIDを1つだけ選びます（例：USD::pce deflator::m/m）。
  2. 該当イベントを示す信頼できる情報源の記述を少なくとも1つ見つけます（公式の発表元のページを優先）。
  3. 情報源をtmp/（gitignore対象）にキャッシュし、1行の抜粋を抽出して、tmp/event_notes_research_log.mdに記録します（コミットしないでください）。
  4. event_notes.jsonの説明を、自然な英語で1～2文に書き込み、または置き換えます。
  5. リポジトリの品質チェック（python scripts/calendar/build_event_notes.py）を実行し、問題が指摘された場合は書き直します。
高速で再現可能なウェブ調査（推奨）

検索と読みやすいページ本文の取得の両方にr.jina.aiを使い、ローカルにキャッシュします。

$ProgressPreference = 'SilentlyContinue'
New-Item -ItemType Directory -Force tmp/sources | Out-Null

# 1) Search (DuckDuckGo HTML via r.jina.ai)
$q = [uri]::EscapeDataString('BLS CPI definition prices paid by urban consumers market basket')
(Invoke-WebRequest -UseBasicParsing "https://r.jina.ai/http://duckduckgo.com/html/?q=$q").Content |
  Set-Content -Encoding utf8 tmp/sources/ddg_cpi.md

# 2) Fetch the best official hit (again via r.jina.ai) and cache it
$url = 'https://www.bls.gov/cpi/'
(Invoke-WebRequest -UseBasicParsing "https://r.jina.ai/$url").Content |
  Set-Content -Encoding utf8 tmp/sources/bls_cpi.md

# 3) Extract one supporting excerpt line for evidence
Select-String -Path tmp/sources/bls_cpi.md -Pattern 'average change over time' | Select-Object -First 1

イベントIDを1つ指定して、ヘルパースクリプトを使うこともできます。

python scripts/calendar/research_event_note_sources.py --event-id "USD::pce deflator::m/m"

このスクリプトはJSONを編集しません。根拠となる記述をより速く見つけ、コピーするための補助のみを行います。

公式サイトからCLIで情報を取得できない場合（WAF、SPA、403）

一部の公式サイトは、CLIからの情報取得が困難です（CloudFrontの403、「Request Rejected」、シングルページアプリなど）。 一般的なテンプレート説明に切り替えてはいけません。

次の順序で対応します。

  1. 公式PDFのプレスリリース／方法論に関する文書（メインサイトより取得しやすいことがよくあります）。
  2. 機関が提供している場合は、公式APIまたは機械可読エンドポイント（JSON／CSV）。
  3. 同じ内容を一字一句そのまま掲載している、公式の別ドメインまたは機械可読ミラー。
  4. 公式の手段がすべて利用できない場合に限り、信頼できる二次情報源（大手金融カレンダーまたは大手報道機関）を使い、説明は定義に厳密に限定します。
証拠の記録（イベントごとに必須）

イベントごとに、短いブロックを tmp/event_notes_research_log.md に追記します。

EVENT: USD::cpi::m/m
SOURCE: https://www.bls.gov/cpi/
EXCERPT: "The Consumer Price Index (CPI) is a measure of the average change over time in the prices paid by urban consumers for a market basket..."
NOTE: (paste your final 1-2 sentence note)

リポジトリの品質ゲート（重要）

このリポジトリでは、python scripts/calendar/build_event_notes.py を通じて、いくつかの注意が必要なチェックを実施します。

  1. 禁止フレーズ：ノート内では、どこにも tracks や growth indicator を使用しないでください。
  2. 文の長さの制限：簡易的な句読点の判定では、. ! ? を文末として数えます。
    • U.S. のようにピリオドを含む略語は、余分な文として誤判定される可能性があるため避けてください。
    • U.S. ではなく US を使い、句読点は最小限にしてください。
  3. ASCII 互換のテキスト：JSON をクリーンで一貫した状態に保つため、曲線引用符は避け（’ の代わりに ' を使用）、ASCII 文字を使ってください。

推奨ワークフロー：

  1. イベントの公式発行元ドメイン（中央銀行、統計局、取引所など）を特定します。
  2. その発行元の複数の指標を扱う「ハブ」ページを1〜3件見つけます（用語集、方法論、リリースのランディングページ、カタログページなど）。
  3. 複数のイベントで抜粋をオフラインで取得できるよう、ハブページをローカルの tmp/ にキャッシュします（Git の追跡対象外）。
  4. イベントごとに、キャッシュ済みのコンテンツから1行の抜粋を抽出するか、必要に応じて特定のページを取得してから、ノートを作成します。
  5. イベントごとに、証拠（URL + 抜粋）を tmp/event_notes_research_log.md に記録します（コミットしないでください）。

オプションのヘルパースクリプト：

  • scripts/calendar/research_event_note_sources.py を使うと、1つのイベント ID について、候補となる情報源や定義に近い抜粋行をすばやく収集できます。
  • このスクリプトは JSON を変更しません。tmp/sources/ にページをキャッシュし、コピーして貼り付けられる証拠の候補を表示するだけです。

例：

python scripts/calendar/research_event_note_sources.py --event-id "USD::m2 money supply::m/m"
python scripts/calendar/research_event_note_sources.py --event-id "USD::opec monthly report::none" --max-results 8
python scripts/calendar/research_event_note_sources.py --event-id "EUR::cpi::y/y" --query "site:ec.europa.eu HICP year-on-year change definition"

PowerShell でのキャッシュ方法：

$ProgressPreference = 'SilentlyContinue'
New-Item -ItemType Directory -Force tmp/sources | Out-Null

# Cache an official hub page once
$url = 'https://www.abs.gov.au/statistics/economy/price-indexes-and-inflation/consumer-price-index-australia/latest-release'
$cache = 'tmp/sources/abs_cpi_latest_release.md'
(Invoke-WebRequest -UseBasicParsing ("https://r.jina.ai/$url")).Content | Set-Content -Encoding utf8 $cache

# For each event, extract a supporting excerpt from the cached file
Get-Content $cache | Select-String -Pattern 'measures household inflation' -Context 0,0 | Select-Object -First 1

検索方法（関連性が高く、ノイズが少ない方法）：

  • site:<official-domain> <indicator name> definition の形式のクエリを優先します。
  • 直接アクセスがブロックされている場合は、検索に https://r.jina.ai/http://duckduckgo.com/html/?q=... を使います。
  • 公式ページにアクセスできない場合に限り、非公式の情報源を使います。

拡散指数のしきい値を維持します：

  • PMI 型の拡散指数については、該当し、分かっている場合はしきい値の説明（例：50 = expansion）を残します。 ノートを短くするためだけにこの詳細を削除しないでください。専門家以外にとっての使いやすさが大きく向上します。

関連性の判断（文2を追加する場合）

次の条件のうち、少なくとも1つに当てはまる場合にのみ、影響に関する文を追加します。

関連性が高い（通常は影響を追加）
  • システム上重要な経済圏における主要な中央銀行の政策決定・ガイダンス（金利決定、声明、議事要旨、記者会見、重要な証言・講演）
  • 世界的な金利見通しを変える可能性のある主要なインフレ指標（総合・コア CPI、または同等の指標、PCE に相当する指標、PPI に相当する指標。特に大規模経済）
  • 金利見通しやリスクセンチメントに影響する主要な労働指標（雇用者数・給与所得者数、失業率、賃金。該当する場合は週次の失業保険申請件数）
  • 大規模経済の主要な活動・リスク指標（PMI/ISM 相当の指標、GDP、小売売上高、鉱工業生産）
関連性が中程度（広く注目される場合、またはカレンダー上で影響が大きい場合に限り影響を追加）
  • 中規模経済の二次的なインフレ・労働・活動データ
  • 市場の注目を集める要因となる場合の貿易収支・経常収支
  • 償還期間の長い国債の入札（利回りや金利をめぐる見方に影響する可能性があります）
関連性が低い（影響を追加しない）
  • 世界の USD・利回り・リスクに影響する可能性が低い、小国の二次的な統計発表
  • 市場の注目が限られるニッチなセクター指標
  • 波及効果がほとんどない地域的なイベント

デフォルトの対応：判断に迷う場合は、文2を省略します（定義のみの記述で問題ありません）。

影響に関する文のルール（文 2 を使う場合）

影響は条件付きで示し、予想との比較で説明してください。

  • 「予想を上回る／予想を下回る（予測との比較）」を使います。
  • 中央銀行については、「タカ派／ハト派のサプライズ」を使います。

影響は、主な経路を 1 つ選んで説明してください（最も関連性の高いものを選び、複数を並べないでください）。

  1. 米ドルと（実質）利回り／金利見通し
  2. リスクセンチメント／安全資産需要
  3. 利回りに波及するインフレ期待

現実的な表現にしてください。「必ずそうなる」という断定ではなく、「可能性があります」「場合があります」「多くの場合」を使います。

禁止事項／機械的な表現を避けるルール

  • 「tracks」は使わないでください。
  • 何でも「成長指標」と呼ばないでください。
  • イベント名をその定義として繰り返さないでください。
  • 通貨コードを国名のようにイベント名の前に付けないでください。
  • 「重要な指標」「経済にとって」などの中身のない表現は避け、何を測定するのかを述べてください。
  • 長く百科事典のような文や、括弧の多用は避けてください。

コード禁止／一括生成禁止ルール（必ず守ること）

  • 説明文を「コードで」生成しないでください。コード、疑似コード、スクリプト、ループ、一括処理のロジック、JSON の一括処理用構造、プレースホルダー、変数のようなトークン（例：{Country}／{Period} や、角括弧で囲まれたテンプレート項目のようなもの）は出力しないでください。
  • イベントの説明は、たとえ数千件あっても、それぞれ自然な言葉で個別に書かれたものにしてください。プログラムでつなぎ合わせたように見える、均一な「コピー＆ペースト用の文型」は避けてください。
  • 生成方法について言及しないでください（「自動生成」「テンプレートを使用」「ルールに基づいて」などのメタ的な文言は禁止です）。最終的な説明文のみを出力してください。

関連性が低い場合の扱い（任意）

影響に触れる必要があるものの、関連性が低い場合は、次のように簡潔な一文だけを使ってください。

  • 「XAUUSD への直接的な影響は通常限定的ですが、米ドル、利回り、またはリスクセンチメント全体に変化があれば影響する可能性があります。」

品質チェック（各イベントについて毎回確認し、満たさない項目があれば書き直すこと）

次のいずれかに当てはまる場合は不合格です。

  • 禁止表現（「tracks」「成長指標」）が含まれている。
  • 文が 2 文を超えている。
  • 文 1 で測定・決定する内容が明確に定義されていない。
  • 文 2 があるのに、「予想を上回る／下回る」または「タカ派／ハト派」の枠組みが含まれていない。
  • 影響が、妥当な形で米ドル／利回り／リスク／安全資産につながっていない。
  • プレースホルダー／変数が含まれている、または一括処理用テンプレートの出力のように見える。
  • イベントごとの情報源確認を行っていない（調査を先に行う要件）。

スタイルの目標（自然な文章にする）

  • 簡潔な動詞を使います：「測定する」「決定する」「反映する」「示す」「提供する」。
  • 具体的な名詞を優先します：数値、指数、政策金利、物価圧力、新規失業保険申請件数。
  • トレーダーにとって読みやすい文体にします。短く、直接的に、余計な表現は避けてください。

例（各国の経済指標カレンダー、XAUUSD に焦点）

  • 「ユーロ圏 CPI（前年比）は消費者インフレ率を測定します。インフレ率が予想を上回ると、利回り見通しが上昇して XAUUSD の重しとなる可能性があり、インフレ率の鈍化は XAUUSD を支える場合があります。」
  • 「日本銀行の金利決定では、政策金利が決まります。予想以上にタカ派的な結果は利回りを押し上げ、XAUUSD の重しとなる可能性があります。ハト派のサプライズは XAUUSD を支える場合があります。」
  • 「中国 PMI は、企業活動を示す景況感指数です（50 は拡大を示します）。数値が予想を下回ると、リスクセンチメントが悪化し、安全資産としての XAUUSD を支える可能性があります。」
  • 「ノルウェーの小売売上高（月次）は、消費支出の前月比変化率を測定します。」（定義のみ）

中核となる実行指示（そのまま使用）

各経済カレンダーのイベントについて、XAUUSD向けの短く読みやすい説明を書いてください。 文は最大2文です。1文目では、イベントが何を測定または決定するのかを、正確な測定用語（率／指数／拡散指数／週間値／変化率／収支／声明／議事録／入札）を使って定義してください。 説明を書く前に、イベントごとにウェブで調査し、そのイベントに関する信頼できる情報源を少なくとも1つ見つけてください（公式発表元を優先）。根拠となる短い抜粋を抽出してから、説明を書いてください。情報源が類似性を裏付けていない限り、国をまたいで同じ表現を使い回さないでください。 効率化のためにキャッシュを活用してください。公式のハブページを優先し、tmp/ に保存して、キャッシュした情報源からイベントごとの抜粋を抽出してください。これにより、根拠の基準を下げずに検索の手間を減らせます。 2文目を加えるのは、イベントがXAUUSDにとって実質的に重要な場合に限ってください（主要中央銀行の政策やガイダンス、主要なインフレ、主要な雇用、または広く注目される経済圏の主要な経済活動・リスク指標、あるいは世界的なドルや利回りの見通し、リスクセンチメントを変動させ得るイベント）。 影響に言及する場合は、必ず予想との比較に基づく条件付きの表現にしてください。「予想を上回る／下回る（予想比）」または「タカ派／ハト派サプライズ」を使い、ドル、利回り／実質利回り、金利見通し、またはリスクセンチメント／安全資産需要を通じた影響を説明してください。 「tracks」は決して使わないでください。すべてを「成長指標」と呼ばないでください。イベント名をそのまま定義として繰り返さないでください。また、通貨コードを国名のようにイベント名の前に付けないでください。 PMI形式の拡散指数では、関連する場合はしきい値の説明（たとえば、50＝拡大）を含めてください。 関連性が低い場合は、定義だけを書いてください（または、直接的な影響は通常限定的だと控えめに1文添えてもかまいません）。書き終えたら自己点検し、ルールに違反している場合は書き直してください。 コード、プレースホルダー、バッチ処理用テンプレートの文言は出力しないでください。説明はそれぞれ、個別に書かれたものとして自然に読めるようにしてください。

コメント

Markdown 対応