niracler/skill

云效 CLI

Ferramenta de linha de comando para o DevOps da Alibaba Cloud (Yunxiao). Registra armadilhas não óbvias e regras de campos obrigatórios da API do Yunxiao, ajudando chamadas bem-sucedidas na primeira tentativa.

Pré-requisitos

Ferramenta	Tipo	Obrigatório	Instalação
yunxiao MCP	mcp	Não	Configure nas configurações MCP do Claude Code (preferido em relação à CLI)
aliyun CLI	cli	Não	brew install aliyun-cli depois aliyun configure — veja openapi.md para configuração completa
git	cli	Sim	brew install git ou git-scm.com
jq	cli	Não	brew install jq (para análise JSON no modo CLI)

Pelo menos uma das ferramentas yunxiao MCP ou aliyun CLI é necessária. MCP é preferido.

NÃO verifique proativamente essas ferramentas ao carregar a skill. Se um comando falhar devido a uma ferramenta ausente, guie o usuário diretamente pela instalação e configuração, passo a passo.

Quando Usar

• Criar/Gerenciar MR: Criar merge requests, atualizar descrições, visualizar listas no repositório codeup.aliyun.com
• Gerenciamento de Tarefas: Consultar/criar/atualizar status de tarefas, adicionar comentários
• Gerenciamento de Releases: Criar Tags via API do Yunxiao

Seleção de Ferramentas

Condição	Forma Recomendada
Serviço MCP conectado (ferramentas mcp__yunxiao__* disponíveis)	Priorizar ferramentas MCP (incluindo operações de MR)
Sem serviço MCP	Usar CLI aliyun
Operações não cobertas pelas ferramentas MCP (atualizar MR, editar comentários, etc.)	Usar CLI aliyun

⚠️ aliyun devops ListRepositories apresenta o erro SYSTEM_UNAUTHORIZED_ERROR. Para obter o ID do repositório, priorize as ferramentas MCP.

Mapeamento de Operações Comuns

Tarefa	Ferramenta MCP	Alternativa CLI
Consultar repositório	mcp__yunxiao__list_repositories	aliyun devops ListRepositories (pode causar erro de permissão)
Criar MR	mcp__yunxiao__create_change_request	aliyun devops CreateMergeRequest
Visualizar MR	mcp__yunxiao__get_change_request	aliyun devops GetMergeRequest
Atualizar MR	—	aliyun devops UpdateMergeRequest
Consultar tarefa	mcp__yunxiao__search_workitems	aliyun devops ListWorkitems
Obter detalhes da tarefa	mcp__yunxiao__get_work_item	—
Atualizar status da tarefa	mcp__yunxiao__update_work_item	API REST (veja openapi.md)
Consultar workflow	mcp__yunxiao__get_work_item_workflow	aliyun devops ListWorkItemWorkFlowStatus
Adicionar comentário	mcp__yunxiao__create_work_item_comment	API REST (veja openapi.md)
Editar comentário	—	aliyun devops UpdateWorkitemComment
Consultar configuração de campos	mcp__yunxiao__get_work_item_type_field_config	aliyun devops ListWorkItemAllFields
Criar Tag	—	aliyun devops CreateTag

Top 5 Armadilhas

As armadilhas mais comuns; regras completas em cheatsheet.md:

1. O campo de ID do repositório é Id (I maiúsculo) — usar .id no jq retorna null
2. Criar MR exige sourceProjectId, targetProjectId, createFrom: "WEB"
3. Atualizar status da tarefa deve usar API REST — aliyun devops POST /organization/.../workitems/updateWorkitemField
4. updateWorkitemPropertyRequest deve ser um array [{...}], os nomes dos campos usam fieldIdentifier/fieldValue
5. Antes de criar uma tarefa, consulte os campos obrigatórios — diferentes projetos têm diferentes campos obrigatórios personalizados

Guias Detalhados

• Leitura obrigatória para assistentes de IA: cheatsheet.md — 13 regras de ouro + tabela completa de erros
• Referência completa da API: openapi.md — guia de configuração, modelos de todas as operações da API, fluxo completo de MR/tarefa/release