/alibabacloud-pts-reporter

name: alibabacloud-pts-reporter
description: |
  Alibaba Cloud PTS report analyzer worker skill — analyzes past PTS stress-testing
  reports (HistoryReportId), identifies report-observable performance issues
  (PTS client config, application-layer errors, throughput/latency patterns),
  and produces ranked, evidence-grounded analysis. This is a READ-ONLY analyzer;
  it does NOT create/start/stop any stress-testing scenario (that belongs to
  `alibabacloud-pts-task`) and does NOT diagnose cloud product instance-level
  bottlenecks (CPU/Memory/DiskIO/Network — those need an instance-level skill).
  Typically delegated from the `alibabacloud-pts-pilot` router.
  Triggers: "压测报告分析", "压测报告解读", "压测结果分析", "PTS report analysis",
  "压测瓶颈分析", "压测指标解读"
required_permissions:
  - pts:GetPtsReportDetails
  - pts:GetPtsSceneRunningData
  - pts:GetPtsSceneBaseLine
  - pts:GetJMeterReportDetails
  - pts:GetPtsScene
  - pts:ListPtsScene

Alibaba Cloud PTS Report Analyzer (alibabacloud-pts-reporter)

> **[SCOPE NOTICE]** > This skill **only** analyzes PTS stress-testing report data. It does **NOT** > perform cloud-product instance-level diagnostics (CPU/Memory/DiskIO/Network > via ECS or CloudMonitor). For instance-level bottleneck analysis, please use > the corresponding cloud-product diagnostic skill.

> **[MUST] Role Declaration** > This is a **read-only analyzer** worker skill. It reads past PTS stress-testing > reports and outputs ranked, evidence-grounded findings. > > **I MUST NOT**: create, start, stop, or delete any PTS scenario. Those actions > belong to `alibabacloud-pts-task`. If the user's request contains such verbs, > surface the boundary and suggest delegation back to the router. > > **I MUST NOT**: diagnose instance-level resource bottlenecks (CPU, memory, > disk-IO, network). Those require ECS/CloudMonitor data and are out of scope. > > **Contract:** > - **Input**: `HistoryReportId` (required) + `RegionId` (required) > - **Output**: `findings[]` — ranked list with `{area, severity, evidence, suggestion}`

---

Scenario Description

Given a user who has run PTS stress tests and wants to interpret the resulting report — or diagnose report-observable issues — this skill reads:

1. **PTS report data** (via `HistoryReportId`): QPS / TPS curve, response-time percentiles (P50/P90/P99), error rate, sampler breakdown, concurrency curve 2. **Optional scene baseline** (via `SceneId` + `GetPtsSceneBaseLine`): for comparison against historical baseline runs

Then maps findings to a curated **report-analysis knowledge base** and produces actionable, ranked findings — strictly bounded by what the report itself exposes.

Architecture

User → Aliyun CLI → PTS (historical report)  ─► alibabacloud-pts-reporter ─► findings[]
                  → PTS (optional baseline)

---

Pre-check

> **Pre-check: Aliyun CLI >= 3.3.3 required** > Run `aliyun version` to verify. If not installed or too low, see > [references/cli-installation-guide.md](references/cli-installation-guide.md) for > installation via package manager or manual download with checksum verification. > Then **[MUST]** run `aliyun plugin install pts` to install the PTS plugin and > `aliyun plugin update`.

aliyun version
aliyun plugin install pts
aliyun plugin update

---

AI-Mode Lifecycle Management

> **[MUST] Enable AI-Mode at workflow start** > ```bash > aliyun configure ai-mode enable > aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-pts-reporter" > ``` > > **[MUST] Disable AI-Mode at EVERY exit point** — success, failure, error, user > cancel, session end. Always disable before the final response. > ```bash > aliyun configure ai-mode disable > ```

---

Authentication

> **Pre-check: Alibaba Cloud Credentials Required** > > **Security Rules:** > - **NEVER** read, echo, or print AK/SK values > - **NEVER** ask the user to input AK/SK directly > - **NEVER** use `aliyun configure set` with literal credential values > - **ONLY** use `aliyun configure list` to check credential status > > ```bash > aliyun configure list > ``` > **If no valid profile exists, STOP here.** > 1. Obtain credentials from [Alibaba Cloud Console](https://ram.console.aliyun.com/manage/ak) > 2. Configure credentials **outside of this session** > 3. Return and re-run after `aliyun configure list` shows a valid profile

---

RAM Policy

See [references/ram-policies.md](references/ram-policies.md) for the full read-only PTS permission set required by this analyzer.

> **[MUST] Permission Failure Handling:** When any command or API call fails due to permission errors at any point during execution, follow this process: > 1. Read `references/ram-policies.md` to get the full list of permissions required by this SKILL > 2. Use `ram-permission-diagnose` skill to guide the user through requesting the necessary permissions > 3. Pause and wait until the user confirms that the required permissions have been granted

---

Parameter Confirmation

> **IMPORTANT: Parameter Confirmation** — Before executing any command or API call, > ALL user-customizable parameters MUST be confirmed with the user. Do NOT assume > or use default values without explicit user approval.

| Parameter | Required | Description | Default | |-----------|----------|-------------|---------| | `RegionId` | ✅ | Region of the PTS report (e.g., `cn-hangzhou`) | — | | `HistoryReportId` | ✅ | Past PTS report ID to analyze | — | | `SceneId` | ✅ **Required (for CLI)** | Required by `get-pts-report-details` / `get-jmeter-report-details`. Also enables baseline pull via `GetPtsSceneBaseLine` for delta comparison | — | | `PlanId` | ✅ **Required (for CLI)** | Required by `get-pts-report-details` / `get-jmeter-report-details` to locate the plan that produced the report | — | | `TopN` | option