• CLI syntax: Run

  aliyun <product> <command> --help

  before constructing commands. Parameter naming is inconsistent across products —

  --RegionId

  vs

  --region-id

  vs

  --region

  all exist.
• Errors: Run

  diagnose_cli_command.py

  immediately on failure. Error messages from the Alibaba Cloud API are often cryptic — the diagnosis script calls a specialized endpoint that maps error codes to fixes.

Pre-check: Aliyun CLI >= 3.3.1 required

Run

aliyun version

to verify >= 3.3.1. If not installed or version too low, see installation guide for instructions.

Then run the following command to enable automatic plugin installation and set the agent user-agent:

bash

aliyun configure set --auto-plugin-install true --user-agent AlibabaCloud-Agent-Skills

This ensures product-specific CLI plugins are downloaded on first use (no manual install needed), and identifies requests as coming from this skill.

bash {{SKILL_PATH}}/scripts/verify_env.sh

1. Compare the user's permissions against references/ram-policies.md
2. If any permission is missing, abort and prompt the user to attach the required policy

• What they want to build or configure
• Which Alibaba Cloud products are involved (or can be inferred)
• Key requirements: region, instance specs, budget, HA needs, environment (dev/staging/prod)

RAG

知识库

AnalyticDB

百炼

references/alicloud-tech-solutions-all.md

Terraform Module 名称

• Column has a value (e.g.,

  analyticdb-rag

  ,

  deepseek-personal-website

  ) → Path A: Terraform
• Column is empty or no matching solution found → Path B: CLI-First

develop-your-wechat-mini-program-in-10-minutes

references/tf-plan/tf-solutions.md

1. Exact module name from the master catalog
2. Keyword match against the 描述 column
3. Intent mapping

Module 地址: https://registry.terraform.io/modules/alibabacloud-automation/<name>/alicloud/latest
GitHub repo: https://github.com/alibabacloud-automation/terraform-alicloud-<name>
Example:     https://raw.githubusercontent.com/alibabacloud-automation/terraform-alicloud-<name>/main/examples/complete/main.tf

main.tf

1. User explicitly specified → always use
2. Example

   main.tf

   from

   examples/complete/

   → use as default
3. Fallback defaults (only if fetch fails): see terraform-defaults.md

Parameters adjusted per user confirmation

Deploy using the remote runtime — see [terraform-online-runtime.md](references/terraform-online-runtime.md) for full usage:

```bash
SKILL_DIR="{{SKILL_PATH}}"
TF="${SKILL_DIR}/scripts/terraform_runtime_online.sh"
STATE_ID=$($TF apply main.tf | grep '^STATE_ID=' | cut -d= -f2)
echo "STATE_ID=$STATE_ID" >> terraform_state_ids.env

• If the master catalog had a matching solution (just without TF Module), it still has tutorial links (部署教程 column). Fetch that page to understand the target architecture, required products, and deployment sequence. This gives you the blueprint — you'll then translate each step into CLI commands.
• If no solution matched at all, reason from the user's description: what products are needed, what depends on what, what's the end state.

• Resource creation order: VPC → VSwitch → Security Group → ECS is almost always the foundation
• ID chaining: which step outputs IDs that later steps need (VpcId → CreateVSwitch, VSwitchId → RunInstances)
• Async operations: some create calls return immediately but the resource takes time — you'll need to poll
• What might not have a CLI: some product activations, some console-only features

1. Verify syntax first:

   aliyun <product> <api> --help

   — catch parameter errors before they hit the API
2. Run the command
3. Verify result: poll async operations; describe the resource to confirm it exists
4. Capture output: save IDs, endpoints, connection strings for subsequent steps and final report

• Resources created (with IDs)
• Access endpoints / connection strings
• How to use what was built
• Cleanup commands (delete in reverse dependency order: ECS → Security Group → VSwitch → VPC)

• Intent Mapping — keyword → solution mapping
• Terraform Defaults — default parameter values
• Terraform Online Runtime — IaCService script usage
• All Tech Solutions Catalog — 187 solutions with TF Module availability
• TF Solutions Detail — 48 Terraform modules with Registry addresses