ucsatp-ews-analysis は何をしますか？
エージェントスキル：UCSATP早期警戒調査2026の分析ファイルおよびロック済みテーブルシェルを作成します（世帯データは含みません）
概要
このスキルは、UCSATP（都市コミュニティ持続可能な適応・変革パートナーシップ）のEarly Warning Survey（EWS）2026年版の分析環境を自動的に準備します。具体的には、以下の作業をエージェントに委任できます。
- 分析用データファイルの生成（集計レベル）
- ロック済みテーブルシェルの作成（出力テーブルのテンプレート）
- コードブックやメタデータの付随ファイルの生成
注意：このスキルは世帯レベルの個別データを扱いません。
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のAIエージェント環境
使用方法
前提条件
- エージェントが適切な権限で実行されていること
- 必要なデータソースへのアクセス（設定済み）
コマンド例
# 分析ファイルの生成（すべてのテーブルシェルをロック）
agent run prepare-ucsatp-ews-analysis --year 2026
# 特定のセクションのみ生成
agent run prepare-ucsatp-ews-analysis --year 2026 --section food-security
スキルの動作
- 設定ファイルを読み込み、分析パラメータを特定します。
- 指定された年（例：2026）の調査データを取得します（世帯データは含みません）。
- 集計処理を実行し、分析用データフレームを作成します。
- ロック済みテーブルシェル（出力テンプレート）を生成します。
- すべての出力ファイルを所定のディレクトリに保存します。
出力ファイル
| ファイル | 説明 |
|---|---|
analysis_data/ | 分析用データファイル（集計済み） |
table_shells/ | ロック済みテーブルシェル |
metadata/ | コードブック、変数定義など |
環境変数
UCSATP_DATA_DIR: データディレクトリのパスUCSATP_OUTPUT_DIR: 出力ディレクトリのパス（デフォルト:./output）
トラブルシューティング
- エラーが発生した場合は、
UCSATP_DATA_DIRが正しく設定されているか確認してください。 - スキルがデータを見つけられない場合、エージェントの実行ディレクトリが適切かどうかをチェックしてください。
このスキルは、UCSATPプロジェクトの一環として開発されました。