alibabacloud-spec-ops

Alibaba Cloud Agent Toolkit

Help AI coding agents build, deploy, and operate applications on Alibaba Cloud.

This repository provides Alibaba Cloud agent plugins, skills, MCP configuration, and validation tooling.

Current Status

The repository currently provides:

• A top-level project scaffold for marketplace manifests, validation, CI, rules, and shared skills.
• Two active plugins: alibabacloud-core and alibabacloud-spec-ops.
• Placeholder plugin directories for future agent and data analytics plugins.

alibabacloud-core includes an SDK usage skill that generates Alibaba Cloud OpenAPI interaction code through a constrained MCP server. alibabacloud-spec-ops delivers a planning-to-execution workflow for Alibaba Cloud infrastructure operations driven by Terraform and IaC Service.

Repository Layout

.
├── plugins/
│   ├── alibabacloud-core/
│   ├── alibabacloud-spec-ops/
│   ├── alibabacloud-agent/
│   └── alibabacloud-data-analytics/
├── rules/
├── skills/
└── tools/

Hook Implementation Convention

alibabacloud-core is the canonical source of truth for the hook implementation. Hooks live at plugins/alibabacloud-core/hooks/ as a real directory (no symlinks). When a new plugin (e.g. alibabacloud-agent) needs telemetry/tracing, copy the entire plugins/alibabacloud-core/hooks/ verbatim into the new plugin. Do not maintain parallel implementations. CI (tools/dev-hooks/verify-hooks.sh) fails on any divergence or on the re-introduction of a hooks/ symlink.

Plugins

Plugin	Status	Description
alibabacloud-core	Active	Alibaba Cloud OpenAPI SDK code generation using the local alibabacloud-core MCP server.
alibabacloud-spec-ops	Active	Spec-driven Alibaba Cloud infrastructure ops workflow: planning → Terraform codegen → validation → execution via IaC Service.
alibabacloud-agent	Placeholder	Reserved for future agent-focused capabilities.
alibabacloud-data-analytics	Placeholder	Reserved for future analytics and data workflow capabilities.

Prerequisites

Python 3.10+ — hook handlers (pre-installed on most systems).

uv (provides uvx) — telemetry tracing view & mcp server:

# macOS
brew install uv

# Linux / WSL
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

Alibaba Cloud CLI (aliyun) — cloud operations:

# Linux amd64
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz | tar xz

# macOS
brew install aliyun-cli

Install Plugins

One-command install (recommended)

npx openplugin acloudlabs-unofficial/alibabacloud-agent-toolkit

Automatically detects installed clients (Claude Code, Codex, QoderWork), lets you pick which plugins to install, and configures everything.

Manual install

Codex

codex plugin marketplace add acloudlabs-unofficial/alibabacloud-agent-toolkit

Then open Codex /plugins and install alibabacloud-core and/or alibabacloud-spec-ops.

Claude Code

/plugin marketplace add acloudlabs-unofficial/alibabacloud-agent-toolkit
/plugin install alibabacloud-core@alibabacloud-agent-toolkit
/plugin install alibabacloud-spec-ops@alibabacloud-agent-toolkit
/reload-plugins

QoderWork

Use the one-command install above (npx openplugin), which handles QoderWork hook registration automatically.

The installer patches ~/.qoderwork/settings.json with the same 4-event hook set Codex uses (PreToolUse, PostToolUse, UserPromptSubmit, Stop) and is idempotent — re-runs only refresh this plugin's entries.

Use Spec-Ops: Spec-Driven Workflow

Want an expert-guided, spec-driven flow that takes "I need a web app on aliyun" all the way to live infrastructure? One command:

/alibabacloud-spec-ops:alibabacloud-planning  I need a web app on aliyun

4 stages, auto-chained, one user gate (right before deploy):