USMetrics

自定义

执行前，请检查以下位置是否有用户自定义设置： ~/.claude/LIFEOS/USER/CUSTOMIZATIONS/SKILLS/USMetrics/

如果此目录存在，请加载并应用其中的任何 PREFERENCES.md、配置或资源。这些内容优先于默认行为。如果此目录不存在，则使用技能默认设置。

🚨 强制要求：语音通知（必须在采取任何操作前执行）

调用此技能时，必须先发送此通知，然后才能进行任何其他操作。

1. 发送语音通知：

   curl -s -X POST http://localhost:31337/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the USMetrics skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. 输出文本通知：

   Running the **WorkflowName** workflow in the **USMetrics** skill to ACTION...
   

此操作不可省略。调用技能后，请立即执行此 curl 命令。

US Metrics - 经济与社会指标分析

功能介绍

从五个政府 API（FRED、EIA、Treasury、BLS、Census）获取 10 个类别中的 68 项美国经济与社会指标——GDP、通胀、就业、住房、消费者金融、市场、贸易、政府/财政、人口统计、健康——并进行分析。包含两种工作流：UpdateData 将实时数据值获取到 Substrate 数据集中；GetCurrentState 则生成涵盖多个时间范围（10y/5y/2y/1y）的趋势概览，并提供跨指标相关性分析、模式检测和研究建议。

问题所在

反映经济实际状况的数据分散在五个联邦机构中，每个机构都有自己的 API、更新频率和发布延迟。手动汇总“经济状况如何？”意味着分别查询 FRED、EIA、Treasury、BLS 和 Census，规范化结果，并对齐不同时间范围的趋势——过程缓慢、容易出错，而且很容易把过时或初步数据当作最终数据来呈现。此技能将全部 68 项指标汇集到一个数据集中，并同时分析四个时间范围的趋势。

工作原理

此技能使用 Substrate US-Common-Metrics 数据集分析美国经济和社会指标，并提供趋势分析、跨指标相关性分析、模式检测和研究建议。必须先运行 UpdateData，确保数据集为最新；随后 GetCurrentState 会读取数据集并计算趋势。

数据来源

所有指标均来自：

• 位置： 配置数据目录路径（例如：${LIFEOS_DIR}/data/US-Common-Metrics/）
• 主文档： US-Common-Metrics.md（涵盖 10 个类别中的 68 项指标）
• 来源文档： source.md（完整方法说明）
• 底层 API： FRED、EIA、Treasury FiscalData、BLS、Census、CDC、EPA

工作流路由

执行工作流时，请直接输出此通知：

Running the **WorkflowName** workflow in the **USMetrics** skill to ACTION...

可用工作流

工作流	触发语句	文件
UpdateData	“更新指标”“刷新数据”“获取最新数据”“更新 Substrate”——从 API 获取实时数据并更新 Substrate 数据集	Workflows/UpdateData.md
GetCurrentState	“经济状况如何？”“经济概览”“获取当前状态”“US metrics 分析”——生成多时间范围的趋势概览	Workflows/GetCurrentState.md

工作流

UpdateData

完整文档： Workflows/UpdateData.md

用途： 从 FRED、EIA 和 Treasury API 获取实时数据，并填充 Substrate US-Common-Metrics 数据集文件。必须先运行此工作流，再运行 GetCurrentState，以确保数据为最新。

执行：

bun ${LIFEOS_SKILL_DIR}/Tools/UpdateSubstrateMetrics.ts

输出：

• US-Common-Metrics.md - 更新为当前值
• us-metrics-current.csv - 机器可读快照
• us-metrics-historical.csv - 追加时间序列数据

触发语句：

• “更新美国指标”
• “刷新经济数据”
• “获取最新指标”
• “更新 Substrate 数据集”

---

GetCurrentState

完整文档： Workflows/GetCurrentState.md

产出： 一份全面的概览文档，分析：

• 所有主要指标的 10 年、5 年、2 年和 1 年趋势
• 跨类别相互作用分析
• 模式检测与异常情况
• 研究建议

触发短语：

• “美国经济状况如何？”
• “给我一份经济概览”
• “美国指标的当前状况如何？”
• “分析经济趋势”
• “美国指标报告”

涵盖的指标类别

1. 经济产出与增长 - GDP、工业生产、零售额
2. 通胀与价格 - CPI、PCE、汽油价格、油价
3. 就业与劳动力 - 失业率、就业人数、失业救济申请人数、离职率
4. 住房 - 房价、抵押贷款利率、新屋开工数
5. 消费者与个人财务 - 信心、储蓄率、信贷
6. 金融市场 - 利率、国债收益率、波动性
7. 贸易与国际 - 贸易差额、美元指数
8. 政府与财政 - 联邦债务、预算赤字、支出
9. 人口与社会 - 人口、不平等、贫困
10. 健康与危机 - 绝望相关死亡、空气质量、预期寿命

所需 API 密钥

用于获取实时数据：

• FRED_API_KEY - 联邦储备经济数据
• EIA_API_KEY - 能源信息署

工具

工具	用途
Tools/UpdateSubstrateMetrics.ts	主要 - 获取所有指标，更新 Substrate 文件
Tools/FetchFredSeries.ts	从 FRED API 获取历史数据
Tools/GenerateAnalysis.ts	根据 Substrate 数据生成分析报告

示例

User: "How is the US economy doing? Give me a full analysis."

→ Invoke GetCurrentState workflow
→ Fetch current + historical data for all metrics
→ Calculate 10y/5y/2y/1y trends
→ Analyze cross-metric correlations
→ Identify patterns and anomalies
→ Generate research recommendations
→ Output comprehensive markdown report

输出格式

GetCurrentState 工作流会生成一份结构化的 Markdown 文档：

# US Economic State Analysis
**Generated:** [timestamp]
**Data Sources:** FRED, EIA, Treasury, BLS, Census

## Executive Summary
[Key findings in 3-5 bullets]

## Trend Analysis by Category
### Economic Output
[10y/5y/2y/1y trends with analysis]
...

## Cross-Metric Analysis
[Correlations, leading indicators, divergences]

## Pattern Detection
[Anomalies, regime changes, emerging trends]

## Research Recommendations
[Suggested areas for deeper investigation]

注意事项

• 来自 5 个机构的 68 项指标（FRED、EIA、财政部、BLS、人口普查局）。每个机构都有各自的 API 速率限制和数据更新时效。
• 经济数据存在发布滞后。 GDP 按季度发布，并会修订。就业数据按月发布。不要将初步数据作为最终数据呈现。
• 跨指标相关性只能说明可能存在关联，并不代表因果关系。 切勿声称某项指标导致了另一项指标的变化。

执行日志

完成任何工作流后，追加一条 JSONL 记录：

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"USMetrics","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/LIFEOS/MEMORY/SKILLS/execution.jsonl

将 WORKFLOW_USED 替换为执行的工作流，将 8_WORD_SUMMARY 替换为简要的输入描述，并将 SECONDS 替换为大致的实际耗时。如果工作流失败，将 status: "error" 记入日志。