Cloud Skills Portal:Get started with Alibaba Cloud Skills

Etapa 1: Acesse o Portal de Skills e selecione uma Skill

1. Acesse o Portal de Skills.

2. Insira uma palavra-chave na caixa de pesquisa no topo da página, como "resource search", ou navegue por categoria de produto.

3. Clique em a Skill desejada para abrir sua página de detalhes. Essa página exibe as capacidades da Skill, o comando de instalação e exemplos de prompts. As etapas a seguir usam a pesquisa global de recursos do Resource Center (alibabacloud-resourcecenter-search) como exemplo.

Etapa 2: Instale a Skill

Na página de detalhes da Skill, clique em Install Guide na parte superior. Selecione suas opções de instalação, copie o comando gerado e execute-o no seu terminal.

npx skills add aliyun/alibabacloud-aiops-skills --skill <skill-name> --agent <client> -y --full-depth

npx clawhub install <skill-name>

npx skills ls

npx skills ls -g

Etapa 3: Use a Skill no seu cliente Agent

Após a instalação, reinicie o cliente Agent para carregar a Skill. Os exemplos a seguir utilizam Claude Code, Cursor e Qoder:

# ECS Instance Search Results
Found **3** ECS instances.

| Instance ID | Instance Name | Region | Status | Instance Type |
|---------|---------|------|------|------|
| i-bp1abc**** | web-server-01 | cn-hangzhou | Running | ecs.g6.large |
| i-bp2def**** | db-server-01 | cn-hangzhou | Running | ecs.r6.xlarge |
| i-bp3ghi**** | test-instance | cn-shanghai | Stopped | ecs.c6.large |

Etapa 4: Experimente mais operações

Após confirmar que a Skill funciona, experimente tarefas mais complexas. A Skill de pesquisa global de recursos do Resource Center aceita prompts como:

Show me all cloud resources in the China East 1 (Hangzhou) region.

Show me the resource count for each product type under my current account.

The application on ECS instance i-bp1xxxxxxx occasionally times out when accessed from the public network. First, diagnose the health status of this instance. Then, analyze the network reachability from the public network to port 80 of this instance. Finally, check whether Cloud Security Center has any related security alerts in the last 24 hours.

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-resourcecenter-search --full-depth

Por que meu cliente Agent não encontra a Skill instalada?

Esse problema geralmente é causado por incompatibilidade de diretório, sessão antiga do cliente ou arquivos incompletos da Skill. Solucione o problema da seguinte forma:

• Verifique se você executou o comando de instalação no diretório correto do projeto. Por padrão, as Skills são instaladas no diretório de nível de projeto .<client>/skills/ e não entram em vigor automaticamente em outros projetos. Para usar uma Skill em vários projetos, adicione o sinalizador -g para instalação global.

• Após a instalação, reinicie o cliente Agent ou reabra o projeto atual no cliente para permitir que ele escaneie novamente o diretório de skills.

• Execute ls .<client>/skills/<skill-name>/ para verificar se o arquivo SKILL.md existe. Se o arquivo estiver ausente ou o diretório vazio, exclua o diretório e execute o comando de instalação novamente.

• Quando uma Skill com o mesmo nome está instalada tanto no escopo project quanto no global, o diretório do projeto tem prioridade. Se uma atualização global não entrar em vigor, verifique se uma versão mais antiga permanece no diretório do projeto.

Por que o comando npx skills add falha?

Falhas na instalação geralmente decorrem do ambiente Node.js, conectividade de rede ou permissões de diretório. Solucione o problema da seguinte forma:

• Se aparecer a mensagem command not found: npx, execute node --version para verificar se o Node.js está instalado e se a versão é 18 ou superior. Se o Node.js não estiver instalado, consulte o site oficial do Node.js para realizar a instalação.

• Se o erro for timeout de rede ou download lento, verifique sua conexão de rede local e tente novamente.

• Se o erro for de permissão (como EACCES ou permission denied), não use sudo para executar npx. Em vez disso, verifique e corrija as permissões de gravação do usuário atual para o diretório do projeto.

• Se o erro for 404 Not Found ou o nome da Skill não existir, acesse o Portal de Skills e verifique se o identificador da Skill está escrito corretamente e se a Skill foi publicada.

Por que ocorrem erros quando o Agent invoca uma Skill?

Erros de invocação geralmente decorrem de problemas com credenciais da CLI, permissões RAM insuficientes ou serviço Resource Center inativo. Solucione o problema da seguinte forma:

• Se o erro for falha de autenticação, execute aliyun sts get-caller-identity para verificar se as credenciais atuais da CLI são válidas e não expiraram. Se tiverem expirado, execute aliyun configure para reconfigurar.

• Se o erro for permissões insuficientes (como Forbidden.RAM ou NoPermission), acesse o console RAM e adicione a política de permissão necessária para o usuário ou função RAM atual. A pesquisa do Resource Center requer a permissão AliyunResourceCenterReadOnlyAccess. Em seguida, solicite que o Agent tente novamente.

• Se o erro indicar que o Resource Center não está ativado (como ServiceNotEnabled), execute aliyun resourcecenter enable-resource-center para ativar o serviço e tente novamente.

• Se o erro envolver uma API específica de produto de nuvem (como ECS ou SAS), consulte a documentação do produto de nuvem correspondente para adicionar as permissões necessárias ao usuário RAM.