analyze-state

name	analyze-state
description	Terraform state を分析・操作する。「state 確認」「state list」「state show」「リソース一覧」「state の移動」「state mv」「state rm」「terraform state」「state 操作」「リソースの状態」「state pull」などで起動。
allowed-tools	["Bash","Read"]
context	fork
agent	shiiman-terraform:state-troubleshooter

State Analyzer

Terraform state ファイルの分析と操作を支援します。

対応操作

操作	トリガー例	コマンド
一覧表示	「state list」「リソース一覧」	terraform state list
詳細表示	「state show」「リソース詳細」	terraform state show
リモート取得	「state pull」「state 取得」	terraform state pull
移動	「state mv」「リソース移動」	terraform state mv
削除	「state rm」「state から削除」	terraform state rm

実行手順

1. 操作の判定

ユーザーの発話から操作を判定:

• 一覧系: 「list」「一覧」「確認」→ state list
• 詳細系: 「show」「詳細」「内容」→ state show
• 取得系: 「pull」「取得」「ダウンロード」→ state pull
• 移動系: 「mv」「移動」「rename」→ state mv
• 削除系: 「rm」「削除」「remove」→ state rm

2. state list

terraform state list

出力例:

aws_instance.web
aws_security_group.web
aws_vpc.main

3. state show

terraform state show {resource_address}

出力例:

# aws_instance.web:
resource "aws_instance" "web" {
    ami                          = "ami-12345678"
    instance_type                = "t3.micro"
    ...
}

4. state pull

terraform state pull

リモートバックエンドから state をダウンロードして表示。

5. state mv（手動実行を案内）

重要: state mv はリソースのアドレスを変更する危険な操作のため、自動実行は禁止されています。

ユーザーに手動実行を案内:

## State 移動

以下のコマンドを手動で実行してください:

terraform state mv {source} {destination}

⚠️ 注意:
- この操作は state を変更します
- 実行前に terraform state list で現在の状態を確認してください
- 間違った移動は terraform state mv で戻せます

6. state rm（手動実行を案内）

重要: state rm はリソースを state から削除する危険な操作のため、自動実行は禁止されています。

ユーザーに手動実行を案内:

## State 削除

以下のコマンドを手動で実行してください:

terraform state rm {resource_address}

⚠️ 注意:
- 実際のインフラリソースは削除されません
- state から削除すると Terraform の管理外になります
- 再度管理するには import が必要です

7. 出力フォーマット

state list:

## State リソース一覧

| # | リソースアドレス |
|---|-----------------|
| 1 | aws_instance.web |
| 2 | aws_security_group.web |
| ... | ... |

合計: {N} リソース

state show:

## リソース詳細: {resource_address}

### 主要属性

| 属性 | 値 |
|------|-----|
| id | {id} |
| ... | ... |

### 全属性

{terraform state show の出力}

よくある使い方

リソースのリネーム

# 旧名から新名に移動
terraform state mv aws_instance.old_name aws_instance.new_name

モジュール化

# ルートからモジュール内に移動
terraform state mv aws_instance.web module.web.aws_instance.main

state から除外

# 管理対象外にする
terraform state rm aws_instance.legacy

注意事項

• ✅ state list / state show / state pull は読み取り専用で安全
• ⚠️ state mv / state rm は state を変更する操作
• ⚠️ state rm は実リソースを削除しない（Terraform 管理外になるだけ）
• ❌ 確認なしで state mv / state rm を実行しない