mcpField
A
aliyun-pts-manage

aliyun-pts-manage

github.com/cinienceTesting & quality39656 installsUpdated 11w ago
Repository

About aliyun-pts-manage

A skill for inspecting and managing load-testing scenarios through Alibaba Cloud PTS OpenAPI, intended for test planning, execution, and troubleshooting. It covers scenario lifecycle controls and report and metrics retrieval, with current-state checks before changes.

Key features

  1. 01Discover PTS API metadata
  2. 02List test scenes with pagination
  3. 03Create, modify, and delete scenes
  4. 04Start or stop pressure tests
  5. 05Retrieve reports, status, and running data

Use cases

  1. 01Inventory and inspect existing test scenes
  2. 02Start a scene and track its status
  3. 03Stop a test or debugging scene
  4. 04Retrieve reports to verify test results

MCP support

The input does not describe an MCP relationship.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-pts-manage

After installing, type/aliyun-pts-managein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
api_quick_map.md
sources.md
templates.md
scripts/
_pts_client.py
list_openapi_meta_apis.py
list_pts_scenes.py
start_pts_scene.py
stop_pts_scene.py

Details

From the project README

Category: service

Alibaba Cloud Performance Testing Service (PTS)

Purpose

Use Alibaba Cloud PTS OpenAPI to support:

  • test scene inventory and inspection
  • pressure test planning and lifecycle automation
  • report and metrics retrieval for verification and troubleshooting

Prerequisites

  • Configure least-privilege Alibaba Cloud credentials.
  • Install Python SDKs (virtual environment recommended):
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U alibabacloud_pts20201020 alibabacloud_tea_openapi
  • Prefer environment variables:
    • ALIBABACLOUD_ACCESS_KEY_ID
    • ALIBABACLOUD_ACCESS_KEY_SECRET
    • optional ALIBABACLOUD_REGION_ID
  • Before mutating operations, run read-only API discovery and current-state checks.

AccessKey Priority

  1. Environment variables: ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID
  2. Shared credentials file: ~/.alibabacloud/credentials

If region/environment is unclear, confirm with user before mutating operations.

Workflow

  1. Identify target region, test scene identifiers, and operation scope.
  2. Run API discovery to confirm API names and required parameters.
  3. Execute read-only APIs first (List* / Get* / Describe*).
  4. Execute mutating operations only after confirming rollback and change window.
  5. Save outputs and evidence to output/aliyun-pts-manage/.

API Discovery

  • Product code: PTS
  • Default API version: 2020-10-20
  • Metadata source: https://api.aliyun.com/meta/v1/products/PTS/versions/2020-10-20/api-docs.json

Minimal Executable Quickstart

python skills/observability/pts/aliyun-pts-manage/scripts/list_openapi_meta_apis.py

Optional arguments:

python skills/observability/pts/aliyun-pts-manage/scripts/list_openapi_meta_apis.py \
  --product-code PTS \
  --version 2020-10-20 \
  --output-dir output/aliyun-pts-manage

List scenes (read-only):

python skills/observability/pts/aliyun-pts-manage/scripts/list_pts_scenes.py \
  --region cn-hangzhou \
  --page-number 1 \
  --page-size 10 \
  --output output/aliyun-pts-manage/scenes.txt

Start one scene (mutating):

python skills/observability/pts/aliyun-pts-manage/scripts/start_pts_scene.py \
  --region cn-hangzhou \
  --scene-id <scene-id> \
  --wait \
  --output output/aliyun-pts-manage/start-result.json

Stop one scene (mutating):

python skills/observability/pts/aliyun-pts-manage/scripts/stop_pts_scene.py \
  --region cn-hangzhou \
  --scene-id <scene-id> \
  --wait \
  --output output/aliyun-pts-manage/stop-result.json

Common Operation Map

  • Scene inventory: ListPtsScene, GetPtsScene, ListOpenJMeterScenes, GetOpenJMeterScene
  • Scene lifecycle: CreatePtsScene, SavePtsScene, ModifyPtsScene, DeletePtsScene, DeletePtsScenes
  • Test execution control: StartPtsScene, StopPtsScene, StartTestingJMeterScene, StopTestingJMeterScene
  • Debug control: StartDebugPtsScene, StopDebugPtsScene, StartDebuggingJMeterScene, StopDebuggingJMeterScene
  • Reports/metrics: ListPtsReports, GetPtsReportDetails, GetPtsSceneRunningData, GetPtsSceneRunningStatus

See references/api_quick_map.md for grouped API lists.

Script Catalog

  • scripts/list_openapi_meta_apis.py: fetch metadata and generate API inventory files.
  • scripts/list_pts_scenes.py: list PTS scenes with pagination.
  • scripts/start_pts_scene.py: start a scene and optionally poll running status.
  • scripts/stop_pts_scene.py: stop a scene and optionally poll until non-running.

Output Policy

Write generated files and execution evidence to: output/aliyun-pts-manage/

Validation

mkdir -p output/aliyun-pts-manage
for f in skills/observability/pts/aliyun-pts-manage/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-pts-manage/validate.txt

Pass criteria: command exits 0 and output/aliyun-pts-manage/validate.txt is generated.

Output And Evidence

  • Save artifacts, command outputs, and API response summaries under output/aliyun-pts-manage/.
  • Include key parameters (region/resource id/time range) in evidence files for reproducibility.

References

  • Source list: references/sources.md
  • API quick map: references/api_quick_map.md
  • request/response templates: references/templates.md

Comments

Markdown supported