run-acceptance-tests

Tổng quan về skill run-acceptance-tests

Skill này làm gì

Skill run-acceptance-tests giúp bạn chạy đúng các acceptance test cho Terraform provider, đặc biệt là những test có tiền tố TestAcc. Skill này được thiết kế cho quy trình Acceptance Testing run-acceptance-tests, nơi nhiệm vụ chính không chỉ là “chạy test,” mà là chạy test với đúng môi trường, diễn giải lỗi đúng cách, và biết khi nào cần thêm phần thiết lập riêng cho provider.

Ai nên dùng

Hãy dùng skill run-acceptance-tests nếu bạn đang làm việc trên một Terraform provider và cần một hướng dẫn thực tế để run-acceptance-tests cho việc xác thực cục bộ, gỡ lỗi CI, hoặc tái hiện một kết quả chập chờn. Skill này hữu ích nhất khi bạn đã có sẵn một acceptance test cụ thể trong đầu và cần một cách chạy đáng tin cậy mà không phải đoán flag hay biến môi trường.

Điểm khác biệt

Skill này có quan điểm rất rõ về trình tự quan trọng: bắt đầu bằng một lệnh go test -run=... có trọng tâm, rồi mới thêm -count=1, -v, TF_LOG=debug, và giữ workspace nếu lần chạy đầu chưa đủ. Vì vậy, run-acceptance-tests skill tốt hơn một prompt chung chung, vì nó mã hóa sẵn một thang chẩn đoán thay vì bắt bạn tự mò.

Cách dùng run-acceptance-tests skill

Cài đặt skill

Cài run-acceptance-tests skill bằng:
npx skills add hashicorp/agent-skills --skill run-acceptance-tests

Nếu bạn đang đánh giá việc cài run-acceptance-tests cho một workflow Terraform provider, hãy xác nhận rằng môi trường của bạn chạy được Go test và bạn có thể thiết lập an toàn thông tin xác thực của provider khi cần. Skill này giả định ngữ cảnh acceptance testing, không phải một project demo độc lập.

Cung cấp mục tiêu test thật cụ thể

Đầu vào tốt nhất là đúng tên TestAcc cụ thể, không phải yêu cầu mơ hồ kiểu “kiểm tra các test của provider.” Ví dụ, hãy yêu cầu như: “Chạy TestAccFeatureHappyPath và chẩn đoán các env vars bị thiếu.” Skill này hoạt động tốt nhất khi tên test mục tiêu, provider, và hành vi kỳ vọng đều được nêu rõ.

Bắt đầu từ đúng file và đúng tín hiệu

Hãy bắt đầu với SKILL.md, rồi xem thêm README.md, AGENTS.md, metadata.json, và các thư mục hỗ trợ như rules/, resources/, references/, hoặc scripts/ nếu có. Trong repository này, hướng dẫn chính tập trung trong SKILL.md, nên việc soi cây thư mục ít quan trọng hơn so với các skill lớn hơn, nhưng vẫn hữu ích để xác nhận không có file trợ giúp ẩn nào khác.

Đi theo thang thực thi và gỡ lỗi

Với lần chạy bình thường, dùng TF_ACC=1 go test -run=TestAccFeatureHappyPath và ban đầu giữ output ở chế độ không verbose. Nếu test lỗi, chạy lại với -count=1 để tránh kết quả cache, rồi thêm -v, sau đó TF_LOG=debug, và chỉ khi đó mới cân nhắc TF_ACC_WORKING_DIR_PERSIST=1 để kiểm tra trạng thái Terraform giữa các bước. Workflow theo từng nấc này là lõi của cách dùng run-acceptance-tests.

Câu hỏi thường gặp về skill run-acceptance-tests

Đây chỉ dành cho acceptance test của Terraform provider thôi à?

Đúng. Skill run-acceptance-tests được giới hạn cho acceptance testing của Terraform provider, đặc biệt là các Go test theo quy ước đặt tên TestAcc. Nó không предназнач cho unit test, bộ Go test tổng quát, hay các kiểm tra hạ tầng không liên quan.

Nếu test cần thêm biến môi trường thì sao?

Điều đó là bình thường. Skill này mặc định rằng một số provider cần thêm biến môi trường và hướng dẫn bạn phát hiện biến nào đang thiếu từ output của test rồi thiết lập chúng một cách an toàn. Nếu thiếu credentials hoặc endpoints, hãy coi đó là một phần của hướng dẫn run-acceptance-tests, không phải lỗi của skill.

Tôi có cần skill này thay cho một prompt bình thường không?

Hãy dùng skill này khi bạn muốn một quy trình lặp lại được, không chỉ một câu trả lời dùng một lần. Một prompt bình thường có thể bảo bạn chạy test; còn run-acceptance-tests skill sẽ chỉ rõ flag nào, biến môi trường nào, và các bước nâng mức debug nào nên dùng khi lần thử đầu tiên thất bại hoặc khi một test đã pass nhưng vẫn cần xác minh thêm.

Skill này có phù hợp cho người mới không?

Có, nếu bạn đã có thể chạy lệnh Go và hiểu các biến môi trường cơ bản. Skill này giảm phần đoán mò cho người mới bằng cách bắt đầu từ một lệnh tập trung và một lộ trình debug rõ ràng, nhưng nó vẫn kỳ vọng bạn nhận ra credentials đặc thù của provider, hành vi của Terraform, và quy ước đặt tên test.

Cách cải thiện run-acceptance-tests skill

Cung cấp ngữ cảnh test mạnh hơn

Đầu vào hữu ích nhất là đúng tên test, package của provider, và triệu chứng bạn đang cố tái hiện. “Run acceptance tests” là quá rộng; “Run TestAccResourceBasic trong package internal/provider và điều tra dấu hiệu TF_LOG bị thiếu” sẽ cho skill đủ ngữ cảnh để chọn hướng đi đúng nhanh hơn.

Chia sẻ chi tiết lỗi, không chỉ trạng thái lỗi

Nếu lần chạy đầu thất bại, hãy đưa cả output đầy đủ của test, các thông báo thiếu biến, và việc kết quả có thay đổi sau -count=1 hoặc -v hay không. run-acceptance-tests skill sẽ hiệu quả hơn khi bạn cung cấp đúng hình dạng của lỗi thực tế, vì acceptance test của provider thường hỏng vì nhiều lý do khác nhau: auth, API từ xa chưa sẵn sàng, state drift, hoặc test bị chập chờn.

Dùng các tùy chọn debug theo đúng thứ tự

Hãy yêu cầu mức nâng cấp tối thiểu cần thiết trước, rồi chỉ mở rộng khi bằng chứng cho thấy cần. Với cách dùng run-acceptance-tests, điều đó thường có nghĩa là bắt đầu bằng một tên TestAcc cụ thể, rồi mới thêm verbose output, debug logs, hoặc workspace persistence sau khi đã biết mình cần kiểm tra gì.

Lặp trên chính test, không chỉ trên lệnh

Nếu bạn cần xác nhận một test pass là có ý nghĩa thật, hãy thay đổi một check hoặc một bước rồi chạy lại, thay vì chỉ lặp lại đúng cùng một lệnh. Điều này làm run-acceptance-tests skill giá trị hơn cho Acceptance Testing, vì nó giúp bạn phân biệt một lần pass thực sự với một âm tính giả, đồng thời dần siết chặt tín hiệu của test theo thời gian.