run-acceptance-tests

run-acceptance-tests 技能概覽

這個技能做什麼

run-acceptance-tests 技能能幫你正確執行 Terraform provider 的 acceptance tests，特別是名稱帶有 TestAcc 前綴的測試。它是為了 run-acceptance-tests 的 Acceptance Testing 工作流程而設計的，重點不只是「把測試跑起來」，而是要在正確的環境下執行、解讀失敗原因，並判斷什麼時候需要額外的 provider 專屬設定。

適合哪些人使用

如果你正在處理 Terraform provider，並且需要一份實用的 run-acceptance-tests 指南，用於本機驗證、CI 除錯，或重現不穩定的結果，就適合用 run-acceptance-tests 技能。當你已經有特定的 acceptance test 想跑，並且需要一個可靠的方法來執行它，而不是靠猜參數或環境變數時，這個技能最有幫助。

它有什麼不同

這個技能對重要的執行順序有明確主張：先從聚焦的 go test -run=... 開始，只有在第一次執行不夠用時，才再加上 -count=1、-v、TF_LOG=debug，以及工作目錄持久化。這讓 run-acceptance-tests 技能比一般提示更強，因為它內建的是一條診斷階梯，而不是要你自己臨場發揮。

如何使用 run-acceptance-tests 技能

安裝這個技能

使用以下指令安裝 run-acceptance-tests 技能：
npx skills add hashicorp/agent-skills --skill run-acceptance-tests

如果你是在評估 Terraform provider 工作流程中的 run-acceptance-tests 安裝，請先確認你的環境可以執行 Go tests，而且在需要時能安全地設定 provider credentials。這個技能預設的是 acceptance-testing 情境，不是獨立的示範專案。

提供精確的測試目標

最好的輸入不是模糊的「幫我檢查 provider tests」，而是具體的 TestAcc 名稱。例如，可以要求：「執行 TestAccFeatureHappyPath，並診斷是否缺少 env vars。」當測試名稱、provider、以及預期行為都講清楚時，這個技能效果最好。

先從正確的檔案與訊號開始

先從 SKILL.md 開始，再查看 repository 裡的 README.md、AGENTS.md、metadata.json，以及任何存在的 rules/、resources/、references/ 或 scripts/ 資料夾。這個 repository 的主要指引集中在 SKILL.md，所以相較於大型技能，檔案樹掃描的重要性較低，但確認沒有隱藏的 helper 檔案仍然有幫助。

依照執行與除錯階梯前進

一般執行時，先用 TF_ACC=1 go test -run=TestAccFeatureHappyPath，並先保持非 verbose 輸出。如果測試失敗，再加上 -count=1 以避免快取結果，接著加 -v，再來是 TF_LOG=debug，最後才考慮 TF_ACC_WORKING_DIR_PERSIST=1，以便在步驟之間檢查 Terraform state。這種分階段的工作流程，就是 run-acceptance-tests 使用方式的核心。

run-acceptance-tests 技能 FAQ

這只適用於 Terraform provider 的 acceptance tests 嗎？

是的。run-acceptance-tests 技能的範圍就是 Terraform provider 的 acceptance testing，特別是採用 TestAcc 命名慣例的 Go tests。它不適用於 unit tests、一般 Go test suite，或其他無關的基礎設施檢查。

如果測試需要額外的環境變數怎麼辦？

這很正常。這個技能本來就假設某些 provider 需要額外的 environment variables，並且會提示你從測試輸出中找出缺少的變數，再以安全方式設定好。如果 credentials 或 endpoints 缺失，應把它視為 run-acceptance-tests 指南的一部分，而不是技能本身出錯。

我需要它來取代一般 prompt 嗎？

當你要的是可重複的程序，而不只是一次性的答案時，就應該使用這個技能。一般 prompt 可能只會告訴你要跑某個測試；run-acceptance-tests 技能則會告訴你，當第一次嘗試失敗，或是測試雖然通過但仍需要驗證時，應該使用哪些 flags、環境變數與升級除錯步驟。

這個技能對新手友善嗎？

如果你已經會跑 Go 指令，並且看得懂基本的環境變數，那答案是肯定的。這個技能從明確的指令與清楚的除錯升級流程開始，能減少新手的猜測，但它仍然期待你能辨識 provider 專屬 credentials、Terraform 行為，以及測試命名慣例。

如何改進 run-acceptance-tests 技能

提供更完整的測試背景

最有價值的輸入，是精確的測試名稱、provider package，以及你想重現的症狀。單說「run acceptance tests」太籠統；像「執行 internal/provider package 裡的 TestAccResourceBasic，並檢查缺少 TF_LOG 線索的問題」這種說法，就能讓技能更快走對路徑。

分享失敗細節，不要只給失敗狀態

如果第一次執行失敗，請附上完整的測試輸出、缺少變數的訊息，以及在加上 -count=1 或 -v 之後結果是否改變。run-acceptance-tests 技能會因為你提供實際的失敗樣貌而變得更有效，因為 provider acceptance tests 失敗的原因常常不同：驗證失敗、遠端 API 尚未就緒、state drift，或測試本身不穩定。

依正確順序使用除錯選項

先要求最少必要的升級，再根據證據決定是否擴大。以 run-acceptance-tests 的用法來說，通常是先從單一、聚焦的 TestAcc 名稱開始，只有在知道需要檢查什麼之後，才再加上 verbose output、debug logs，或工作區持久化。

針對測試迭代，不只是重跑指令

如果你要確認一個通過的測試是否真的有意義，應該只改一個檢查或一個步驟後重新執行，而不是一直重複同一條指令。這會讓 run-acceptance-tests 技能在 Acceptance Testing 裡更有價值，因為它能幫你區分真正的通過與假陰性，並隨著時間拉高測試訊號的品質。