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 - 経済・社会指標の分析

概要

5つの政府 API（FRED、EIA、Treasury、BLS、Census）から、10のカテゴリ（GDP、インフレーション、雇用、住宅、消費者金融、市場、貿易、政府・財政、人口統計、健康）にわたる68の米国経済・社会指標を取得し、分析します。ワークフローは2つあります。UpdateData は最新の値を取得して Substrate データセットに格納し、GetCurrentState は複数の期間（10年／5年／2年／1年）にわたる傾向の概要を、指標間の相関、パターン検出、調査の推奨事項とともに作成します。

課題

経済の実態を示す数値は、独自の API、更新頻度、公表の遅れを持つ5つの連邦機関に分散しています。「経済の状況は？」を手作業でまとめるには、FRED、EIA、Treasury、BLS、Census に個別にアクセスし、結果を正規化して、異なる期間の傾向を揃える必要があります。時間がかかり、エラーが発生しやすいうえ、古いデータや暫定データを確定値のように示してしまいがちです。このスキルは、68の指標を1つのデータセットに集約し、4つの期間の傾向を一度に読み取ります。

仕組み

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. 貿易・国際 - 貿易収支、USD 指数
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 エントリを1つ追加してください。

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" を記録してください。