terraform-search-import
作者 hashicorp了解 terraform-search-import 如何透過 Terraform Search 探索支援的雲端資源，並將其批次匯入 Terraform state。這個 terraform-search-import 技能特別適合後端開發、稽核與遷移流程，當你需要一份實用指南來安裝、驗證 provider 支援，並以更少猜測開始使用時。
這個技能評分 72/100，因為它具備實際的工作流程價值，且有足夠的儲存庫證據，足以讓目錄使用者做出安裝決策。它明確鎖定一項特定的 Terraform 任務——探索受支援的資源並批次匯入未受管理的基礎架構——但流程略為不完整，且取決於 Terraform/provider 支援度，因此使用者應期待的是一份有用、但不算完全自成一體的實作指南。
- 觸發性強：description 與「When to Use」章節清楚對準未受管理的基礎架構探索、稽核，以及遷移到 Terraform 的需求。
- 操作性高：包含用於檢查 provider list-resource 支援性的輔助腳本，可在嘗試 search/import 前減少猜測。
- 工作流程內容可信：提及批次匯入與手動匯入的替代指引，且沒有佔位或僅供測試的訊號。
- 執行會依賴 Terraform >= 1.14 與 provider 的 list-resource 支援，因此適用性會受環境與 provider 能力限制。
- 節錄中的決策樹與手動匯入參考顯示有替代路徑，但主流程看起來仍偏複雜，使用者可能還是需要具備 Terraform 經驗。
terraform-search-import 技能概覽
terraform-search-import 的用途
terraform-search-import 技能可幫你透過 Terraform Search 查詢找出既有雲端資源，接著再批次匯入 Terraform state。當你的基礎架構已經存在，想把它納入 Terraform 管控，而不是為每個物件逐一手動對應時，這個技能特別有用。
適合誰使用
這個 terraform-search-import 技能很適合後端開發團隊、平台工程師，以及處理遷移、資產盤點或治理工作的維運人員。當你需要稽核未受管理的資源、標準化佈署流程，或以較少猜測的方式從手動雲端設定轉向 IaC 時，它最有價值。
為什麼它不一樣
它最大的優勢是從 provider 支援開始，而不是先假設結果。這個技能會先確認某種 resource type 是否能透過 Terraform Search 被發現，之後你才進入批次匯入路徑，這能減少走進死路或產生失敗提示的機會。當 provider 不支援 list resources 時，它也會引導你改走手動備援方案。
如何使用 terraform-search-import 技能
安裝並驗證環境
請在 repo 情境下使用 terraform-search-import 安裝指令：npx skills add hashicorp/agent-skills --skill terraform-search-import。接著確認你的工作目錄已初始化 Terraform、可執行 terraform，而且已安裝 jq，因為輔助 script 需要這兩者。這個技能預設 Terraform >= 1.14，且 provider 版本具備 list resource 支援。
先做支援性檢查
在要求匯入計畫之前，先執行 ./scripts/list_resources.sh <provider>，或直接在提示中檢視同樣的輸出。這是最快判斷 Terraform Search 是否能處理目標 object type 的方式。如果 resource 沒有出現在清單裡，就直接改用手動匯入參考，不要硬推 search workflow。
提供明確的匯入目標
好的提示會清楚寫出 provider、resource type、範圍與目標。例如：Use terraform-search-import to discover and bulk import all aws_s3_bucket resources in us-east-1 for account prod, then show the Terraform Search query and import steps. 這類較完整的輸入，可以減少 region、account，以及你到底只想做 discovery、還是 discovery 加 state import 之間的模糊地帶。
先讀對的檔案
若要實際使用 terraform-search-import，請先從 SKILL.md 開始，再看 references/MANUAL-IMPORT.md，最後看 scripts/list_resources.sh。SKILL.md 提供整體 workflow，MANUAL-IMPORT.md 說明不支援 resource 的備援路徑，而 script 則揭示這個技能預期你使用的 provider capability 檢查方式。
terraform-search-import 技能 FAQ
terraform-search-import 只適合批次匯入嗎？
不是。它也很適合在匯入前先做 resource discovery 與支援性驗證。如果你只需要一次性匯入單一資源，標準的 Terraform import workflow 可能更簡單。
什麼情況下不該使用這個技能？
如果 provider 對你的目標 type 沒有提供 list resource 支援，或者你無法在環境中執行 terraform init，就不應該使用 terraform-search-import。這些情況下，手動匯入指引會更合適。
這對初學者友善嗎？
如果你已經知道想管理哪個 cloud resource，並且能辨識對應的 provider，那就算友善。這個技能能降低設定摩擦，但你仍需要基本的 Terraform 與 provider 理解，才能解讀輸出並確認匯入後的 state。
它和一般提示有什麼不同？
一般提示可能會直接給出匯入步驟，卻不會先檢查 provider 能力或工具前提。terraform-search-import 指引把 workflow 建立在 Terraform Search 支援之上，因此結果更可執行，也比較不容易在後段才失敗。
如何改進 terraform-search-import 技能
提供會影響結果的輸入
最好的結果來自明確告訴技能 provider、精確的 resource type、環境範圍，以及你要的是 discovery、import，還是兩者都要。例如：Find all supported azurerm_storage_account resources in subscription dev, then prepare bulk import instructions，會比「import my cloud resources」好得多。
留意最常見的失敗模式
最大的失敗是把 terraform-search-import 用在不支援的資源上。如果支援性檢查沒有回傳內容，就應該停止，改看 references/MANUAL-IMPORT.md，不要硬湊成 search-based 解法。這樣可以省時間，也能讓 workflow 和 provider 的實際能力保持一致。
從 discovery 逐步走到 import
一個好的流程是：先驗證支援性，再列出 resources，接著選擇較小的範圍，確認第一個 resource 沒問題後，再擴大到完整集合。這個順序有助於你在批次匯入產生雜訊 state 之前，先抓出命名不一致、權限不足，以及 region 或 account 漂移等問題。
用真實盤點細節強化提示
如果你已經知道範例 resource names、ARN、ID，或 account 與 region 的邊界，請一併提供。這些細節能幫助 terraform-search-import 產生更精準的 query 與更安全的匯入計畫，尤其是在後端開發環境中，當同一種 resource type 可能跨越多個 stage 時特別重要。