/release-testing
Run automated UAT tests (UI or API) using a test profile on the AWS DevOps Agent
> /plugin marketplace add aws/agent-toolkit-for-awsHow it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/release-testing
Context preview
What this command does when you run it.
Run automated UAT tests (UI or API) using a test profile on the AWS DevOps Agent
Command definition
release-testing.mddescription: Run automated UAT tests (UI or API) using a test profile on the AWS DevOps Agent
argument-hint: [test profile ID]
Read and follow the `running-release-tests` skill for full execution details.
Step 0 — Choose your execution path (DO THIS FIRST)
Check your available tools. Do you have ALL of these tools?
- `aws_devops_agent__create_release_testing_job`
- `aws_devops_agent__get_task`
- `aws_devops_agent__list_journal_records`
- `aws_devops_agent__get_release_ui_testing_report`
- `aws_devops_agent__get_release_api_testing_report`
These tools are NOT deferred/lazy-loaded — if they do not appear in your tool list, they are unavailable. Do NOT search for them via ToolSearch.
- **YES (all present)** → Use the "Remote Server" path (steps 4-8 below)
- **NO** → Tell the user: "Remote server not configured." Then prompt the user with instructions from the `setup-devops-agent` skill if they intend to set up the connection. If not, mention that you are "proceeding with the AWS CLI fallback." Then use the Fallback (CLI) path below.
---
Steps 1-3 — Common to both paths (see skill: "Gathering test parameters")
1. If `$ARGUMENTS` contains a test profile ID (e.g., `ki-12345`), use it directly. 2. If `$ARGUMENTS` is empty, ask the user which test profile to use. 3. Ask if the user has a specific test requirement or focus area.
Steps 4-8 — Remote Server path (see skill: "Core workflow")
1. Call `aws_devops_agent__create_release_testing_job(test_profile_id="...", webhook_event_message="...")`. 2. Tell the user tests take 10+ minutes and you'll keep them posted. 3. Poll `aws_devops_agent__get_task(task_id=TASK_ID)` every 30s. 4. Stream progress via `aws_devops_agent__list_journal_records(execution_id=EXEC_ID, order="ASC")`. 5. On `COMPLETED`: call `aws_devops_agent__get_release_ui_testing_report(execution_id=EXEC_ID)` (UI) or `aws_devops_agent__get_release_api_testing_report(execution_id=EXEC_ID)` (API), and save to file.
Steps 9-12 — Fallback (CLI) path
Use this path when the remote server tools are unavailable.
1. List agent spaces with `aws devops-agent list-agent-spaces --region us-east-1` and ask the user which one to use. 2. Start the job:
aws devops-agent create-backlog-task \
--agent-space-id SPACE_ID \
--task-type RELEASE_TESTING \
--title 'Release Testing' \
--priority MEDIUM \
--description '{"testProfileId": "<PROFILE_ID>", "webhookEventMessage": "<REQUIREMENT>"}' \
--region us-east-13. Poll for status every 30s:
aws devops-agent get-backlog-task \
--agent-space-id SPACE_ID \
--task-id TASK_ID \
--region us-east-14. On completion, retrieve the report. For UI testing, use --record-type qa_ui_testing_report, and for API testing, use --record-type qa_api_testing_report:
aws devops-agent list-journal-records \
--agent-space-id SPACE_ID \
--execution-id EXEC_ID \
--record-type qa_ui_testing_report \
--order ASC \
--region us-east-1Save to file.
---
If `$ARGUMENTS` is empty and no test profile ID is provided, prompt the user.
Read more
description: Run automated UAT tests (UI or API) using a test profile on the AWS DevOps Agent argument-hint: [test profile ID]
Read and follow the `running-release-tests` skill for full execution details.
Step 0 — Choose your execution path (DO THIS FIRST)
Check your available tools. Do you have ALL of these tools?
- `aws_devops_agent__create_release_testing_job`
- `aws_devops_agent__get_task`
- `aws_devops_agent__list_journal_records`
- `aws_devops_agent__get_release_ui_testing_report`
- `aws_devops_agent__get_release_api_testing_report`
These tools are NOT deferred/lazy-loaded — if they do not appear in your tool list, they are unavailable. Do NOT search for them via ToolSearch.
- **YES (all present)** → Use the "Remote Server" path (steps 4-8 below)
- **NO** → Tell the user: "Remote server not configured." Then prompt the user with instructions from the `setup-devops-agent` skill if they intend to set up the connection. If not, mention that you are "proceeding with the AWS CLI fallback." Then use the Fallback (CLI) path below.
---
Steps 1-3 — Common to both paths (see skill: "Gathering test parameters")
1. If `$ARGUMENTS` contains a test profile ID (e.g., `ki-12345`), use it directly. 2. If `$ARGUMENTS` is empty, ask the user which test profile to use. 3. Ask if the user has a specific test requirement or focus area.
Steps 4-8 — Remote Server path (see skill: "Core workflow")
1. Call `aws_devops_agent__create_release_testing_job(test_profile_id="...", webhook_event_message="...")`. 2. Tell the user tests take 10+ minutes and you'll keep them posted. 3. Poll `aws_devops_agent__get_task(task_id=TASK_ID)` every 30s. 4. Stream progress via `aws_devops_agent__list_journal_records(execution_id=EXEC_ID, order="ASC")`. 5. On `COMPLETED`: call `aws_devops_agent__get_release_ui_testing_report(execution_id=EXEC_ID)` (UI) or `aws_devops_agent__get_release_api_testing_report(execution_id=EXEC_ID)` (API), and save to file.
Steps 9-12 — Fallback (CLI) path
Use this path when the remote server tools are unavailable.
1. List agent spaces with `aws devops-agent list-agent-spaces --region us-east-1` and ask the user which one to use. 2. Start the job:
aws devops-agent create-backlog-task \
--agent-space-id SPACE_ID \
--task-type RELEASE_TESTING \
--title 'Release Testing' \
--priority MEDIUM \
--description '{"testProfileId": "<PROFILE_ID>", "webhookEventMessage": "<REQUIREMENT>"}' \
--region us-east-13. Poll for status every 30s:
aws devops-agent get-backlog-task \
--agent-space-id SPACE_ID \
--task-id TASK_ID \
--region us-east-14. On completion, retrieve the report. For UI testing, use --record-type qa_ui_testing_report, and for API testing, use --record-type qa_api_testing_report:
aws devops-agent list-journal-records \
--agent-space-id SPACE_ID \
--execution-id EXEC_ID \
--record-type qa_ui_testing_report \
--order ASC \
--region us-east-1Save to file.
---
If `$ARGUMENTS` is empty and no test profile ID is provided, prompt the user.
Help AI coding agents build, deploy, and manage applications on AWS. The Agent Toolkit for AWS gives AI coding agents the tools, knowledge, and guardrails they need to work with AWS services.
Repo: aws/agent-toolkit-for-aws
Other commands on agent-toolkit-for-aws.
- /chat
Open a chat session with the AWS DevOps Agent and ask a question
Open command - /cost
Ask the AWS DevOps Agent for cost optimization opportunities, scoped to your local IaC
Open command - /investigate
Start a deep root-cause investigation on the AWS DevOps Agent and stream progress
Open command - /release-readiness
Trigger a pre-merge release readiness review on a GitHub PR, GitLab MR, or local branch
Open command - /setup-devops-agent
Set up the AWS DevOps Agent MCP connection
Open command - /setup-security-agent
Set up the AWS Security Agent workspace
Open command

