alicloud-find-skills

阿里云 Agent Skills 搜索与发现

通过 Aliyun CLI 的 agentexplorer 插件搜索、浏览和安装阿里云官方 Agent Skills。

---

前置条件

1. Aliyun CLI >= 3.3.3

aliyun version

如未安装或版本过低：

# macOS
brew install aliyun-cli

# Linux (x86_64)
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o /tmp/aliyun-cli.tgz
tar -xzf /tmp/aliyun-cli.tgz -C /tmp
sudo mv /tmp/aliyun /usr/local/bin/

# Linux (ARM64)
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o /tmp/aliyun-cli.tgz
tar -xzf /tmp/aliyun-cli.tgz -C /tmp
sudo mv /tmp/aliyun /usr/local/bin/

⚠️ 安全提示：避免使用 curl | bash 管道安装模式。先下载脚本审查内容再执行更安全。

2. 认证配置

aliyun configure list

安全规则：

• 禁止读取、回显或打印 AK/SK 值（echo $ALIBABA_CLOUD_ACCESS_KEY_ID 严禁执行）
• 禁止在对话中要求用户直接输入 AK/SK
• 禁止使用 aliyun configure set 传入明文凭据值
• 仅用 aliyun configure list 检查凭据状态

如无有效 profile，告知用户：

1. 在 RAM 控制台 获取 AccessKey
2. 在终端中执行 aliyun configure 完成配置（不在当前会话中操作）
3. 配置完成后返回继续

3. 插件安装

# 启用自动插件安装
aliyun configure set --auto-plugin-install true

# 安装 agentexplorer 插件
aliyun plugin update
aliyun plugin install --names agentexplorer

# 验证
aliyun plugin list | grep agentexplorer

---

API 调用规范

所有 aliyun agentexplorer 命令必须携带以下标志：

本地管理命令（aliyun configure、aliyun plugin、aliyun version）不支持 --user-agent 标志。

---

核心工作流

Step 1: 理解需求

分析用户请求，提取：

• 领域：ECS、RDS、OSS、SLS、PAI 等
• 任务：诊断、部署、数据同步、权限审查等
• 搜索意图：将用户需求转化为能力导向的搜索短语

Step 2: 搜索 Skills

# 语义搜索（默认，按意图匹配）
aliyun agentexplorer search-skills \
  --keyword "<用户意图>" \
  --search-mode semantic \
  --max-results 20 \
  --endpoint 'agentexplorer.aliyuncs.com' \
  --user-agent AlibabaCloud-Agent-Skills/alicloud-find-skills

# 关键词搜索
aliyun agentexplorer search-skills \
  --keyword "<产品关键词>" \
  --search-mode semantic \
  --max-results 20 \
  --endpoint 'agentexplorer.aliyuncs.com' \
  --user-agent AlibabaCloud-Agent-Skills/alicloud-find-skills

# 浏览类目
aliyun agentexplorer list-categories \
  --endpoint 'agentexplorer.aliyuncs.com' \
  --user-agent AlibabaCloud-Agent-Skills/alicloud-find-skills

# 按类目列出 skills
aliyun agentexplorer search-skills \
  --category-code "<category-code>" \
  --max-results 20 \
  --endpoint 'agentexplorer.aliyuncs.com' \
  --user-agent AlibabaCloud-Agent-Skills/alicloud-find-skills

# 类目 + 语义组合搜索
aliyun agentexplorer search-skills \
  --keyword "<意图>" \
  --category-code "<category-code>" \
  --search-mode semantic \
  --max-results 20 \
  --endpoint 'agentexplorer.aliyuncs.com' \
  --user-agent AlibabaCloud-Agent-Skills/alicloud-find-skills

Step 3: 迭代搜索

首次搜索无明确匹配时，自动调整策略重试：

1. 提取产品/任务关键词
2. 中英文切换（"云服务器" → "ECS"，"对象存储" → "OSS"）
3. 简化关键词（"RDS 备份自动化" → "RDS"）
4. 先 list-categories 定位类目，再组合搜索
5. 尝试同义词（"实例" → "ECS"，"桶" → "OSS"）

每个搜索意图单元至少尝试一次能力导向搜索后才可声明"无对应 Skill"。

Step 4: 查看详情（可选）

aliyun agentexplorer get-skill-content \
  --skill-name "<skill-name>" \
  --endpoint 'agentexplorer.aliyuncs.com' \
  --user-agent AlibabaCloud-Agent-Skills/alicloud-find-skills

Step 5: 安装（仅用户要求时）

# OpenClaw 生态安装
npx clawhub install <selected-skill-name>

# 或通过 npx skills add
npx skills add aliyun/alibabacloud-aiops-skills \
  --skill <skill-name> \
  --full-depth \
  --agent qwen-code \
  -g -y

⚠️ 安装前审查：建议先用 get-skill-content 查看待安装 skill 的内容，确认安全后再安装。

安装后验证 skill 出现在可用列表中。

---

RAM 权限

本 skill 仅使用只读 API，所需最小权限：

最小 RAM 策略：

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "agentexplorer:ListCategories",
      "agentexplorer:SearchSkills",
      "agentexplorer:GetSkillContent"
    ],
    "Resource": "*"
  }]
}

权限错误时：告知用户所需权限 → 暂停等待用户授权 → 确认后继续。

---

常用场景示例

---

安全注意事项

• 最小权限：仅使用 3 个只读 API 权限，不涉及任何写操作
• 凭据保护：严禁暴露 AK/SK，严禁在会话中配置凭据
• 子 skill 审查：本 skill 引导安装其他 skill，安装前务必审查内容
• 安装风险：npx 会从 npm 下载执行代码，确认包来源可信后再安装
• CLI 安装：优先使用包管理器（brew / 手动下载二进制）而非 curl | bash