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. 第 1 句（必需）：使用精确的衡量术语，说明事件衡量或决定的内容：
    • 利率、政策决定、指数、扩散指数、每周数据、百分比变化、余额、声明、会议纪要、拍卖
  3. 第 2 句（可选）：仅在事件可能通过主要定价渠道影响 XAUUSD 时添加。

研究优先要求（避免复制粘贴式说明）

除非已针对确切事件核实，否则不要对多个事件重复使用通用说明（例如，“CPI 衡量通胀”）。

每个事件的最低要求：

  1. 找到至少一个可信来源，说明该确切国家/发布机构的指标或决策。
  2. 摘录一段简短的佐证内容（一行即可）。
  3. 然后才用自然英文撰写 1-2 句说明。

来源优先级：

  1. 官方发布机构（中央银行/统计局/部委/交易所/财政部/机构）。
  2. 该指标的官方新闻稿/PDF/网页。
  3. 如果难以获取官方来源，则使用可靠的金融日历/主要新闻媒体作为后备来源。

提高效率，同时避免模板化说明（缓存 + 官方“汇总”页面）

目标：在减少重复网页搜索和尽量降低 token 用量的同时，保持“逐个事件”取证标准。

原则：

  1. 每个事件仍需有自己的佐证摘录（一行）和最终说明。
  2. 提高效率的方式是复用官方来源（而不是复用措辞）。

配额友好模式（不使用 Agent）

如果无法使用多个 Agent（受配额限制），不要改用通用模板说明。 保持每个事件的取证标准，并通过以下方式加快研究：

  1. 使用辅助脚本搜索并缓存候选页面（tmp/sources/）。
  2. 使用 site: 将搜索范围限定为官方域名（例如 site:bls.gov、site:bea.gov、site:census.gov）。
  3. 对相关变体（水平值、月环比、同比）复用已缓存的官方“汇总”页面，同时仍须单独撰写每个事件的说明。

本仓库的具体工作流（这里的“良好实践”）

在本仓库中遵循此技能时，预期工作流如下：

  1. 选定且只处理一个事件 ID（例如，USD::pce deflator::m/m）。
  2. 为该确切事件找到至少一条可信来源内容（优先选择官方发布机构页面）。
  3. 将来源缓存到 tmp/（已加入 git 忽略），提取一行摘录，并记录到 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：

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.，因为可能会被误计为多个句子。
    • 优先使用 US，而不是 U.S.，并尽量少用标点。
  3. ASCII 安全文本：避免使用弯引号（用 ' 代替 ’），以确保 JSON 保持干净一致。

建议的工作流：

  1. 确定事件官方发布机构的域名（央行、统计局、交易所等）。
  2. 找到 1-3 个涵盖该发布机构多个指标的“中心”页面（词汇表、方法论、发布落地页、目录页）。
  3. 将中心页面缓存到本地 tmp/ 下（已加入 gitignore），以便离线提取多个事件的摘录。
  4. 对每个事件，从缓存内容中提取一行摘录（必要时也可获取特定页面），然后撰写笔记。
  5. 在 tmp/event_notes_research_log.md 中记录每个事件的证据（URL + 摘录）（不要提交）。

可选辅助脚本：

  • 使用 scripts/calendar/research_event_note_sources.py，快速收集某个事件 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）

仅当至少满足以下一项条件时，才添加影响说明：

高相关性（通常应添加影响说明）
  • 具有系统重要性的经济体的重大央行政策决策/指引（利率决策、声明、会议纪要、新闻发布会、关键证词/讲话）
  • 可能改变全球利率预期的重大通胀数据（总体/核心 CPI 或同类指标、PCE 同类指标、PPI 同类指标，尤其是大型经济体）
  • 影响利率预期或风险情绪的重大劳动力市场数据（就业/工资总额、失业率、工资；如适用，也包括每周申领失业救济人数）
  • 大型经济体的重大经济活动/风险指标（PMI/ISM 同类指标、GDP、零售销售、工业生产）
中等相关性（仅当市场广泛关注或日历上影响较大时，才添加影响说明）
  • 中型经济体的次要通胀/劳动力市场/经济活动数据
  • 作为市场关注焦点的贸易差额/经常账户
  • 长期政府债券拍卖（可能影响收益率/利率叙事）
低相关性（不要添加影响说明）
  • 不太可能影响全球 USD/收益率/风险的小国次级数据发布
  • 市场关注度有限的细分行业指标
  • 溢出影响较小的本地事件

默认做法：如不确定，则省略句子 2（仅提供定义也完全可以）。

影响句规则（如果使用句子 2）

影响必须是有条件的，并且相对于预期：

  • 使用：“高于预期 / 低于预期（相对于预测值）”
  • 对于央行：“鹰派 / 鸽派意外”

影响必须通过一个主要渠道来解释（选择最相关的渠道，不要堆叠多个渠道）：

  1. 美元和（实际）收益率 / 利率预期
  2. 风险情绪 / 避险需求
  3. 通胀预期对收益率的影响

保持表述贴合实际：使用“可能”“往往”等措辞，不要绝对地说“将会”。

禁用 / 反机械化规则

  • 禁止使用：“tracks”
  • 不要把所有内容都称为“增长指标”
  • 不要用事件名称重复定义事件本身
  • 不要在事件前加上货币代码，仿佛货币就代表国家
  • 避免使用“重要指标”或“对经济而言”之类的填充语；应说明指标实际衡量的内容
  • 避免冗长、百科全书式的句子和过多括号

禁止代码 / 批量生成规则（必须遵守）

  • 不要“通过代码”生成描述。不要输出任何代码、伪代码、脚本、循环、批处理逻辑、JSON 批量结构、占位符或变量式标记（例如 {Country} / {Period} 之类的内容，或方括号模板字段）。
  • 每条事件描述都必须读起来自然，仿佛是单独撰写的，即使事件有成千上万个。避免使用明显像程序拼接出来的统一“复制粘贴式句型”。
  • 不要提及生成方式（不要出现“自动生成”“使用模板”“基于规则”等元文本）。只输出最终描述文本。

低相关性处理（可选）

如果必须提及影响，但相关性较低，只写一句克制的表述：

  • “除非该指标改变美元、收益率或整体风险情绪，否则对 XAUUSD 的直接影响通常有限。”

质量检查（逐条检查每个事件；若不符合则重写）

以下情况视为不合格：

  • 出现禁用短语（“tracks”“growth indicator”）
  • 超过 2 个句子
  • 句子 1 未清楚定义指标衡量或决定的内容
  • 存在句子 2，但没有说明高于 / 低于预期或鹰派 / 鸽派
  • 影响与美元 / 收益率 / 风险 / 避险之间缺乏合理联系
  • 文本包含任何占位符 / 变量，或看起来像批量模板生成的内容
  • 未逐项核实事件来源（研究优先要求）

风格目标（让表达更自然）

  • 使用简单动词：衡量、设定、反映、显示、提供
  • 优先使用具体名词：读数、指数、政策利率、价格压力、每周申领人数
  • 面向交易者，简短直接，不说废话

示例（全球经济日历，聚焦 XAUUSD）

  • “欧元区 CPI（同比）衡量消费者通胀。通胀高于预期可能推高收益率预期，令 XAUUSD 承压；通胀走软则可能为其提供支撑。”
  • “日本央行利率决议设定政策利率。结果比预期更鹰派可能推高收益率，令 XAUUSD 承压；鸽派意外则可能为其提供支撑。”
  • “中国 PMI 是衡量商业活动的扩散指数（50 = 扩张）。读数低于预期可能损害风险情绪，并因避险需求而支撑 XAUUSD。”
  • “挪威零售销售（月环比）衡量消费者支出的月度百分比变化。”（仅定义）

核心执行指令（原样使用）

针对每个经济日历事件，为 XAUUSD 撰写简短、易懂的描述。 最多使用两个句子。第一句必须使用精确的测量术语（利率／指数／扩散指数／周度数量／百分比变化／差额／声明／会议纪要／拍卖）说明该事件衡量或决定的内容。 撰写前，逐项进行网络调查：为该具体事件找到至少一个可信来源（优先选择官方发布方），摘录一段简短的佐证内容，然后再撰写说明。除非来源支持相似表述，否则不要在不同国家之间重复使用相同措辞。 为提高效率，请使用缓存：优先选择官方汇总页面，将其保存到 tmp/，并从缓存来源中提取各事件的摘录。这样可以减少搜索开销，同时不降低证据标准。 只有当事件与 XAUUSD 有实质关联时才添加第二句（例如，广受关注经济体的主要央行政策／指引、重大通胀、主要劳动力或经济活动／风险指标，或任何可能改变全球美元和收益率预期或风险情绪的事件）。 若添加影响说明，必须以相对于市场预期的条件表述：使用“高于预期／低于预期（相较于预测）”或“鹰派／鸽派意外”，并说明其如何通过美元、收益率／实际收益率、利率预期或风险情绪／避险需求产生影响。 绝不要使用“追踪”，不要把所有内容都称为“增长指标”，不要用事件名称重复定义事件本身，也不要在事件前加上货币代码，仿佛货币代码等同于国家。 对于 PMI 类扩散指数，在适用时保留阈值说明（例如，50 = 扩张）。 若相关性较低，只写定义（或者酌情用一句非常克制的话说明其直接影响通常有限）。撰写后进行自检，如有违反任何规则之处，请重写。 不要输出任何代码、占位符或批处理模板文本。每条描述都必须读起来像是针对该事件单独撰写的。

评论

支持 Markdown