/alibabacloud-liverecord-diagnosis

name: alibabacloud-liverecord-diagnosis
description: |
  Alibaba Cloud Live Recording Diagnostic Skill. Use for diagnosing live stream record issues including missing recordings, file generation problems, unexpected recording behavior, and callback issues.
  Triggers: "live record", "live stream record diagnosis", "record not working", "record file missing", "record callback issue", "录制诊断", "直播录制问题".

Alibaba Cloud Live Recording Diagnostic Skill

Scenario Description

This skill provides comprehensive diagnostic capabilities for Alibaba Cloud ApsaraVideo Live recording issues. It helps identify and troubleshoot problems related to:

• Live stream not being recorded
• Recording files not generated
• Recording files not meeting expectations (missing audio/video, wrong format, etc.)
• Recording callbacks not received or incorrect
• Other live recording-related issues

**Architecture**: ApsaraVideo Live + OSS/VOD + Recording Configuration + Callback Configuration

Diagnostic Scope

**Within Scope:** 1. Live stream not being recorded 2. Recording files not generated or incomplete 3. Recording files missing audio or video tracks 4. Recording callback issues (not received, incorrect data) 5. Recording configuration validation 6. Stream quality issues affecting recording

**Out of Scope:**

• Issues unrelated to live recording (use Alibaba Cloud official AI assistant)
• Writing/modifying user configurations (user must modify via console or CLI themselves)

---

Installation

**Pre-check: Aliyun CLI >= 3.3.3 required**

> Run `aliyun version` to verify >= 3.3.3. If not installed or version too low, see [references/cli-installation-guide.md](references/cli-installation-guide.md) for detailed installation instructions.

**Pre-check: Aliyun CLI plugin update required**

> [MUST] run `aliyun configure set --auto-plugin-install true` to enable automatic plugin installation. > [MUST] run `aliyun plugin update` to ensure that any existing plugins are always up-to-date.

**Install Live Plugin:**

aliyun plugin install --names live

---

Authentication

> **Pre-check: Alibaba Cloud Credentials Required** > > **Security Rules:** > - **NEVER** read, echo, or print AK/SK values (e.g., `echo $ALIBABA_CLOUD_ACCESS_KEY_ID` is FORBIDDEN) > - **NEVER** ask the user to input AK/SK directly in the conversation or command line > - **NEVER** use `aliyun configure set` with literal credential values > - **ONLY** use `aliyun configure list` to check credential status > > ```bash > aliyun configure list > ``` > Check the output for a valid profile (AK, STS, or OAuth identity). > > **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** (via `aliyun configure` in terminal or environment variables in shell profile) > 3. Return and re-run after `aliyun configure list` shows a valid profile

---

RAM Policy

The following RAM permissions are required for this diagnostic skill. See [references/ram-policies.md](references/ram-policies.md) for the complete policy document.

**Required Actions:**

• `live:DescribeLiveDomainMapping` - Query domain mappings
• `live:DescribeLiveStreamRecordContent` - Query recording content
• `live:DescribeLiveStreamRecordIndexFiles` - Query recording index files
• `live:DescribeLiveRecordConfig` - Query recording configuration
• `live:DescribeLiveRecordVodConfigs` - Query VOD recording configuration
• `live:DescribeLiveRecordNotifyConfig` - Query callback configuration
• `live:DescribeLiveStreamsOnlineList` - Query online streams
• `live:DescribeLiveStreamsPublishList` - Query stream publish history
• `live:DescribeLiveCenterStreamRateData` - Query stream rate data
• `live:DescribeLiveRecordNotifyRecords` - Query callback records

> **[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 (e.g., domain names, stream names, application names, time ranges, region IDs, etc.) MUST be confirmed with the user. Do NOT assume or use default values without explicit user approval. Note that Alibaba Cloud Live API or CLI may UTC timezone. Convert the time from user local zone when calling API/CLI.

**Required Parameters:**

| Parameter Name | Required/Optional | Description | Default Value | |---------------|-------------------|-------------|---------------| | `live-stream-url` | **Required** | The live stream URL to diagnose (used to extract DomainName, AppName, StreamName) | N/A | | `issue-description` | **Required** | Description of the recording issue | N/A | | `time-range` | Optional | Time range for diagnosis (format: YYYY-MM-DD HH:mm:ss, user local zone) | Past 1 day (expand to 7 days if no data) | | `biz-region-id` | Optional | Business region ID | Default region from CLI config |

---

Core Workflow

> At the **start** of the Core Workflow (before any CLI invocation): > **[MUST] Enable AI-Mode** — AI-mode is required for Agent Skill execution. > Run the following commands before any CLI invocation: > ```bash > aliyun configure ai-mode enable > aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-liverecord-diagnosis" > ```

Step 1: Identify User Intent and Validate Information Completeness

**1.1 Validate Diagnostic Scope**

Check if the issue is within the diagnostic scope:

• Live stream not recorded
• Recording files not generated
• Recording files no