Azure Cli Toolkit

SKILL.md

---
slug: azure-cli-toolkit
name: azure-cli-toolkit
version: "1.0.0"
displayName: Azure命令行工具专业版
summary: 企业级Azure云管理,支持批量操作、自动化脚本、多订阅管理与成本优化分析
license: Proprietary
edition: pro
description: |-
  面向企业团队的高级 Azure 云平台管理工具,在免费版基础上扩展自动化、批量操作与成本治理能力。核心能力:
  - 服务主体与托管身份认证(自动化场景)
  - 批量资源操作与脚本化部署
  - 多订阅跨租户统一管理
  - 成本分析与资源优化建议
  - 策略合规审计与安全基线检查

  适用场景:
  - 企业级基础设施自动化部署
  - 多环境(开发/测试/生产)统一管理
  - 云成本治理与资源清理

  差异化:
  - 兼容免费版全部命令,无缝升级
  - 支持自动化脚本与 CI/CD 集成
  - 提供成本优化与合规审计能力
  -...
tags:
- 云平台
- Azure
- 命令行工具
- 自动化
- 企业级
- 成本治理
tools:
  - - read
- exec
---
# Azure命令行工具专业版

## 核心能力

### 1. 自动化认证方式
| 认证方式 | 适用场景 | 命令 |
|:---------|:---------|:-----|
| 服务主体 | CI/CD、自动化脚本 | `az login --service-principal` |
| 托管身份 | Azure 资源内部调用 | `az login --identity` |
| 令牌认证 | 无状态流水线 | `az login --service-principal --password-stdin` |

```bash
# 服务主体认证(自动化场景)
az login --service-principal \
  --username $AZURE_CLIENT_ID \
  --password $AZURE_CLIENT_SECRET \
  --tenant $AZURE_TENANT_ID

# 托管身份认证(虚拟机内部)
az login --identity

# 令牌认证(CI/CD)
echo "$AZURE_ACCESS_TOKEN" | az login --service-principal \
  -u $AZURE_CLIENT_ID --password-stdin --tenant $AZURE_TENANT_ID
```

**输出**: 返回自动化认证方式的执行结果,包含操作状态和输出数据。
### 2. 批量资源操作
```bash
# 批量删除资源组下所有虚拟机
az vm list -g myRG -d --query "[].id" -o tsv | xargs az vm delete --ids --yes

# 批量停止所有运行中的虚拟机
az vm list -d --query "[?powerState=='VM running'].id" -o tsv | xargs az vm stop --ids

# 按标签批量筛选资源
az resource list --tag env=production --query "[].id" -o tsv
```

**输入**: 用户提供批量资源操作所需的指令和必要参数。
**输出**: 返回批量资源操作的执行结果,包含操作状态和输出数据。

- 执行`批量资源操作`操作,处理输入数据并返回结果
- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `批量资源操作` 选项

### 3. 自动化部署脚本
```bash
#!/bin/bash
set -e  # 出错即退出

# 创建资源组
az group create -g prod-rg -l eastus

# 创建虚拟机并获取 ID
VM_ID=$(az vm create \
  -g prod-rg \
  -n prod-vm \
  --image UbuntuLTS \
  --query id \
  --output tsv)

echo "Created VM: $VM_ID"

# 验证状态
az vm show --ids "$VM_ID" --query provisioningState

# 配置网络安全组
az network nsg create -g prod-rg -n prod-nsg
az network nsg rule create -g prod-rg --nsg-name prod-nsg \
  -n allow-ssh --priority 1000 \
  --source-address-prefixes '*' \
  --destination-port-ranges 22 \
  --access Allow --protocol Tcp
```

**输入**: 用户提供自动化部署脚本所需的指令和必要参数。
**处理**: 按照skill规范执行自动化部署脚本操作,遵循单一意图原则。

- 执行`自动化部署脚本`操作,处理输入数据并返回结果
- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `自动化部署脚本` 选项

### 4. 多订阅管理
```bash
# 列出所有订阅
az account list --query "[].{name:name, id:id, state:state}" -o table

# 跨订阅操作
for sub in $(az account list --query "[].id" -o tsv); do
  az account set --subscription $sub
  echo "=== 订阅: $(az account show --query name -o tsv) ==="
  az vm list -o table
done
```

**输入**: 用户提供多订阅管理所需的指令和必要参数。
**处理**: 按照skill规范执行多订阅管理操作,遵循单一意图原则。
**输出**: 返回多订阅管理的执行结果,包含操作状态和输出数据。

- 执行`多订阅管理`操作,处理输入数据并返回结果
- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `多订阅管理` 选项

### 5. 成本分析与优化
```bash
# 查看订阅费用(本月)
az consumption usage list \
  --top 10 \
  --query "[].{service:instanceName, cost:pretaxCost}" \
  -o table

# 识别未使用的资源
az resource list --query "[?tags.env=='dev']" -o table

# 查看虚拟机实际使用率
az monitor metrics list \
  --resource $(az vm show -g myRG -n myVM --query id -o tsv) \
  --metric "Percentage CPU" \
  --interval PT1H -o table
```

**输入**: 用户提供成本分析与优化所需的指令和必要参数。
**处理**: 按照skill规范执行成本分析与优化操作,遵循单一意图原则。
**输出**: 返回成本分析与优化的执行结果,包含操作状态和输出数据。

### 6. 策略合规审计
```bash
# 查看策略分配
az policy assignment list -o table

# 合规状态检查
az policy state list --query "[?complianceState=='NonCompliant']" -o table

# 安全基线扫描
az security assessment list -o table
```

**输入**: 用户提供策略合规审计所需的指令和必要参数。
**输出**: 返回策略合规审计的执行结果,包含操作状态和输出数据。

### 能力覆盖范围

本skill还覆盖以下能力场景: 企业级、云管理、支持批量操作、多订阅管理与成本、优化分析、面向企业团队的高、云平台管理工具、在免费版基础上扩、展自动化、批量操作与成本治、理能力、核心能力、服务主体与托管身、批量资源操作与脚、本化部署、多订阅跨租户统一、成本分析与资源优、化建议、策略合规审计与安、全基线检查。这些能力在上述核心功能中均有对应处理逻辑。
## 适用场景

### 场景一: 企业级基础设施自动化部署

通过脚本化方式部署完整的生产环境。

```bash
#!/bin/bash
set -e

ENV=${1:-dev}
RG="app-${ENV}-rg"
LOCATION="eastus"

# 1. 创建资源组
az group create -g $RG -l $LOCATION

# 2. 部署应用服务
az deployment group create \
  -g $RG \
  --template-file infra/main.bicep \
  --parameters env=$ENV location=$LOCATION

# 3. 配置监控
az monitor log-analytics workspace create \
  -g $RG -n "logs-${ENV}" -l $LOCATION

# 4. 输出部署结果
echo "部署完成: $ENV 环境"
az resource list -g $RG --query "[].{name:name, type:type}" -o table
```

### 场景二: 多环境统一管理

统一管理开发、测试、生产三个环境的资源状态。

```bash
# 批量查询所有环境资源
for env in dev test prod; do
  echo "=== 环境: $env ==="
  az resource list -g "app-${env}-rg" \
    --query "[].{name:name, type:type, location:location}" \
    -o table
done

# 批量启停(夜间自动关停开发环境)
az vm list -g app-dev-rg --query "[].id" -o tsv | \
  xargs az vm deallocate --ids
```

### 场景三: 成本治理与资源清理

识别闲置资源并清理,优化云成本。

```bash
# 查找未附加的磁盘
az disk list --query "[?diskState=='Unattached']" -o table

# 查找停止超过 7 天的虚拟机
az vm list -d --query "[?powerState!='VM running']" -o table

# 批量删除未使用的存储容器
az storage container list \
  --account-name mystorage \
  --query "[?properties.leaseStatus=='unlocked'].name" -o tsv | \
  xargs -I {} az storage container delete \
    --account-name mystorage -n {}
```

## 使用流程

### 优秀步: 配置服务主体

```bash
# 创建服务主体
az ad sp create-for-rbac --name my-automation-sp

# 示例
# {
#   "appId": "详情见说明xx-详情见说明x-详情见说明x",
#   "password": "详情见说明xx-详情见说明x-详情见说明x",
#   "tenant": "详情见说明xx-详情见说明x-详情见说明x"
# }

# 配置环境变量
export AZURE_CLIENT_ID="<appId>"
export AZURE_CLIENT_SECRET="<password>"
export AZURE_TENANT_ID="<租户ID>"
```

### 第二步: 初始化项目配置

```bash
mkdir -p .azure-toolkit/{scripts,templates,reports}

cat > .azure-toolkit/config.json << 'EOF'
{
  "edition": "pro",
  "default_location": "eastus",
  "environments": ["dev", "test", "prod"],
  "auto_shutdown": {
    "dev": "22:00",
    "test": "20:00"
  },
  "cost_alert_threshold": 1000
}
EOF
```

### 第三步: 运行自动化部署

```bash
# 执行部署脚本
./.azure-toolkit/scripts/deploy.sh prod
```

### 命令参数说明

- `-analytics`: 命令参数,用于指定操作选项
- `--subscription`: 命令参数,用于指定操作选项
- `--protocol`: 命令参数,用于指定操作选项
- `--resource`: 命令参数,用于指定操作选项
- `--template-file`: 命令参数,用于指定操作选项

### 命令参数说明

- `--priority`: 命令参数,用于指定操作选项
- `-dev-rg`: 命令参数,用于指定操作选项
- `-client-secret`: 命令参数,用于指定操作选项
- `--username`: 命令参数,用于指定操作选项
- `-vm`: 命令参数,用于指定操作选项

### 命令参数说明

- `-client-id`: 命令参数,用于指定操作选项
- `-resource-id`: 命令参数,用于指定操作选项
- `--yes`: 命令参数,用于指定操作选项
- `-nsg`: 命令参数,用于指定操作选项
- `--account-name`: 命令参数,用于指定操作选项

### 命令参数说明

- `--access`: 命令参数,用于指定操作选项
- `--tenant`: 命令参数,用于指定操作选项
- `--vault-name`: 命令参数,用于指定操作选项
- `-tenant-id`: 命令参数,用于指定操作选项
- `--image`: 命令参数,用于指定操作选项

### 命令参数说明

- `-scan`: 命令参数,用于指定操作选项
- `--output`: 命令参数,用于指定操作选项
- `-subscription-id`: 命令参数,用于指定操作选项
- `--query`: 命令参数,用于指定操作选项
- `--metric`: 命令参数,用于指定操作选项

### 命令参数说明

- `-I`: 命令参数,用于指定操作选项
- `--top`: 命令参数,用于指定操作选项
- `--interval`: 命令参数,用于指定操作选项
- `--source-address-prefixes`: 命令参数,用于指定操作选项
- `--nsg-name`: 命令参数,用于指定操作选项

### 命令参数说明

- `-ssh`: 命令参数,用于指定操作选项
- `-automation-sp`: 命令参数,用于指定操作选项
- `--destination-port-ranges`: 命令参数,用于指定操作选项
- `--parameters`: 命令参数,用于指定操作选项
- `--ids`: 命令参数,用于指定操作选项

### 命令参数说明

- `-I`: 命令参数,用于指定操作选项

### 命令参数说明

- `-I`: 命令参数,用于指定操作选项

## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| content | string | 是 | 相关说明 |
| content | string | 否 | 相关说明, 默认: 全部维度 |
| strict_level | string | 否 | 审查严格度, 可选: strict/normal/loose, 默认: normal |

## 输出格式

```json
{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}
```

## 异常处理


| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 待审查内容为空 | 用户未提供内容 | 提示用户提供待审查的代码 |
| 内容格式不识别 | 传入不支持的内容格式 | 列出支持的格式, 建议转换后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 |
| 检查项超出范围 | 传入了不存在的检查维度 | 列出可用检查维度, 使用默认全部检查 |
| 审查超时 | 内容过长导致处理超时 | 建议分段审查, 每段不超过5000字 |
| 其他异常 | 内部处理异常 | 检查输入后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 |

## 依赖说明

### 运行环境

- **Agent 平台**: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- **操作系统**: Windows / macOS / Linux
- **Azure CLI**: v2.50 或更高版本
- **Bash**: 4.0+(自动化脚本执行)

### 依赖说明

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| Azure CLI | CLI 工具 | 必需 | brew / apt / choco 安装 |
| Azure 订阅 | 云服务 | 必需 | azure.com 注册 |
| 服务主体 | 认证 | 自动化必需 | `az ad sp create-for-rbac` |
| jq | CLI 工具 | 推荐 | 系统包管理器 |
| xargs | CLI 工具 | 批量操作必需 | 系统自带 |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |

### API Key 配置

自动化场景需配置服务主体凭据:

```bash
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"
export AZURE_TENANT_ID="your-tenant-id"
export AZURE_SUBSCRIPTION_ID="your-subscription-id"
```

建议使用 Azure KeyVault 管理敏感凭据:

```bash
# 从 KeyVault 获取密钥(推荐)
az keyvault secret show --vault-name myVault -n azure-client-secret \
  --query value -o tsv
```

### 可用性分类

- **分类**: MD+EXEC+SCRIPT(Markdown 指令 + 命令行执行 + 自动化脚本)
- **说明**: 通过自然语言指令驱动 Agent 执行 `az` 命令,支持脚本化批量操作与 CI/CD 集成
- **离线可用**: 否,所有操作需要连接 Azure 云平台

## 案例展示

### 示例1: 基础用法
**输入**:
```json
{
  "content": "示例内容",
  "strict_level": "normal"
}
```
**输出**:
```
评级: B级(良好) - 总分: 85/100

检查详情:
- 代码风格: 通过(95分) - 检查通过
- 安全合规: 警告(75分) - 检查通过
- 无障碍性: 通过(85分) - 检查通过

改进建议:
1. [高优先级] 建议优化
2. [中优先级] 建议优化
```

### 示例2: 进阶用法
**输入**:
```json
{
  "content": "示例内容",
  "strict_level": "strict"
}
```
**输出**:
```
评级: C级(及格) - 总分: 70/100

检查详情:
- 代码风格: 通过(90分) - 检查通过
- 安全合规: 不通过(50分) - 检查通过
- 无障碍性: 警告(70分) - 检查通过

改进建议:
1. [高优先级] 建议优化
2. [高优先级] 建议优化
3. [低优先级] 建议优化
```

### 示例3: 边界情况 - 边界情况
**输入**:
```json
{
  "content": "示例内容"
}
```
**输出**:
```
评级: D级(不及格) - 总分: 45/100

检查详情:
- 代码风格: 不通过(40分) - 检查通过
- 安全合规: 不通过(30分) - 检查通过
- 无障碍性: 通过(65分) - 检查通过

改进建议:
1. [紧急] 建议优化
2. [高优先级] 建议优化
```

## 常见问题

### Q1: 专业版是否兼容免费版的命令?

完全兼容。专业版使用相同的 `az` 命令语法,免费版的所有命令在专业版中可直接使用。

### Q2: 服务主体的密码过期了怎么办?

```bash
# 重置服务主体密码
az ad sp credential reset --name <appId> --password <new-password>
```

### Q3: 如何在 CI/CD 中安全存储凭据?

使用 CI/CD 平台的密钥管理功能(如 Azure KeyVault、GitHub Secrets),不要在代码中硬编码凭据。

### Q4: 批量操作误删了资源怎么办?

专业版支持软删除恢复:

```bash
# 恢复已删除的资源
az resource recover --ids <deleted-resource-id>
```

### Q5: 成本分析数据延迟多久?

成本数据通常有 8-24 小时延迟,建议结合监控指标做实时预估。

### Q6: 策略合规扫描多久执行一次?

建议每周执行一次全量扫描,新资源部署后立即扫描:

```bash
az policy state trigger-scan
```

## 错误处理


| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接，执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

## 已知限制

- 依赖云服务，需要网络连接