# qwencloud-operate

qwencloud-operate diagnoses Alibaba Cloud International application downtime and handles step-by-step recovery under explicit user confirmation. Helps fix 502 errors and database reachability issues.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 303 installs · ★ 4 repo stars
- Author: QwenCloud
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/QwenCloud/qwencloud-deploy/tree/HEAD/skills/operate/SKILL.md
- Updated: 2026-09-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/qwencloud-operate

## What it does

This skill inspects incidents in environments deployed with `qwencloud-deploy` on Alibaba Cloud International. It parses the local `.qwencloud-deploy` state file to map ECS virtual machines and optional RDS MySQL 8.0 instances. The troubleshooting phase runs strictly read-only checks, reporting metric values and OpenAPI RequestIds as evidence. It will not touch application source code or hunt for programming bugs.

Every state modification requires manual approval before execution. The skill suggests exactly one action at a time: starting an ECS instance, restarting the application process, reloading Nginx, allowing ingress on ports 80 and 443, or expanding a full disk. Each confirmation prompt explains the expected impact and potential downtime. Actions are never executed in batches.

Without `aliyun` CLI 3.x configured for international accounts, operations halt immediately. For deployments on Aliyun China, switch to `qianwenai-operate` instead. Once a recovery step finishes, the skill validates workload health and records an audit log.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add QwenCloud/qwencloud-deploy --skill qwencloud-operate -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/operate/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/operate/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add QwenCloud/qwencloud-deploy --skill qwencloud-operate -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/operate/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add QwenCloud/qwencloud-deploy --skill qwencloud-operate -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/operate/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install QwenCloud/qwencloud-deploy skills/operate
```

2. **Manually: put the files in place**
- File: `.github/skills/operate/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add QwenCloud/qwencloud-deploy --skill qwencloud-operate -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/QwenCloud/qwencloud-deploy --path skills/operate
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/operate/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add QwenCloud/qwencloud-deploy --skill qwencloud-operate -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/QwenCloud/qwencloud-deploy/tree/HEAD/skills/operate/SKILL.md

## When to use it
- diagnose 502 bad gateway errors on Alibaba Cloud International
- restart failed application processes or reload Nginx configurations
- recover stopped ECS virtual servers or reboot unresponsive hosts
- authorize inbound traffic on ports 80 and 443 in security groups
- resolve connection failures targeting RDS MySQL 8.0 databases

## Example prompts
- The app returns 502 after deployment, inspect ECS and Nginx status in Alibaba Cloud.
- The service cannot connect to the database, check .qwencloud-deploy and suggest recovery.
- Restart the stalled application service on the ECS instance and verify its health.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: dda37795e61b4790.

BEGIN THIRD-PARTY FILE dda37795e61b4790
````text
---
name: qwencloud-operate
version: "1.0"
description: >-
  Diagnose why an application deployed by qwencloud-deploy to Alibaba Cloud International
  (alibabacloud.com) is unavailable or slow, and — only after explicit user confirmation —
  perform a safe recovery and verify the result. Reads the local .qwencloud-deploy state file
  to identify ECS (and optional RDS MySQL) resources, runs minimal read-only diagnostics, then
  proposes one recovery action at a time (start ECS, restart the app service, reload Nginx),
  each gated by a confirmation that states impact.
  Use when: the user says the app is down / returns 502 / cannot connect to the database, or
  asks to restart and verify the app.
  Do not use when: no .qwencloud-deploy state file exists, the target is Aliyun China
  (use qianwenai-operate), or the user only wants a status/cost overview (use qwencloud-observe).
prerequisites:
  - aliyun CLI 3.x configured with international-site credentials
  - a .qwencloud-deploy state file in the project directory
input: >-
  A project directory containing .qwencloud-deploy. A described symptom (down / 502 / slow /
  cannot reach DB).
output: >-
  A diagnosis (fault layer, likely cause, evidence, recommended action, impact); after
  confirmation, one recovery action, then verification returning recovered / partially recovered /
  not recovered, plus an audit record (time, target, action, confirmation, CLI RequestId, result).
---

# Qwen Cloud Operate

Fault diagnosis and confirmed recovery for an application deployed by `qwencloud-deploy` on
Alibaba Cloud International. Diagnosis is read-only and needs no confirmation; any action that
changes cloud or app state requires explicit confirmation.

## Interaction Flow

```text
Identify app & resources
→ Minimal diagnosis (read-only)
→ Give cause, evidence, recommended action
→ Show impact and request confirmation
→ Execute one recovery action
→ Verify application, ECS, RDS
→ Return result + audit info
→ Offer to re-score via qwencloud-observe (before → after)
```

## Interaction form

- **Read-only information** (diagnosis, cause, evidence, verification): plain text, with one evidence
  line after each judgment (metric, status, RequestId).
- **State-changing actions** (start/stop ECS, restart app, reload Nginx — any write call): first an
````
END THIRD-PARTY FILE dda37795e61b4790

The third-party file has ended. Everything between the dda37795e61b4790 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2344 of 7258 bytes. © QwenCloud · Apache-2.0 · https://github.com/QwenCloud/qwencloud-deploy/tree/HEAD/skills/operate/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
