About yunxiao
yunxiao is a command-line skill for Alibaba Cloud Yunxiao DevOps, with guidance on API requirements and common pitfalls. It helps manage merge requests, work items, and release tags through Yunxiao MCP or aliyun CLI.
Key features
- 01Create, inspect, and manage merge requests
- 02Search and update work items and comments
- 03Create tags through the API
- 04Document required fields and API pitfalls
Use cases
- 01Create or inspect merge requests in Codeup repositories
- 02Find work items and update their status
- 03Refer to API templates when creating release tags
MCP support
It recommends using Yunxiao MCP for supported repository, merge request, and work-item operations. Operations not covered by MCP can use aliyun CLI.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/yunxiaoin Claude Code to confirm it loaded.
Bundled filesreferences/cheatsheet.mdreferences/openapi.md
Details
From the project README云效 CLI
阿里云云效 DevOps 命令行工具。记录了云效 API 的非显而易见的陷阱和必填字段规则，帮助一次调用成功。
Prerequisites
| Tool | Type | Required | Install |
|---|---|---|---|
| yunxiao MCP | mcp | No | Configure in Claude Code MCP settings (preferred over CLI) |
| aliyun CLI | cli | No | brew install aliyun-cli then aliyun configure — see openapi.md for full setup |
| git | cli | Yes | brew install git or git-scm.com |
| jq | cli | No | brew install jq (for JSON parsing in CLI mode) |
At least one of yunxiao MCP or aliyun CLI is required. MCP is preferred.
Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.
When to Use
- 创建/管理 MR：在 codeup.aliyun.com 仓库上创建合并请求、更新描述、查看列表
- 任务管理：查询/创建/更新任务状态、添加评论
- 发布管理：通过云效 API 创建 Tag
工具选择
| 条件 | 推荐方式 |
|---|---|
MCP 服务已连接（mcp__yunxiao__* 工具可用） | 优先使用 MCP 工具（包括 MR 操作） |
| 无 MCP 服务 | 使用 aliyun CLI |
| MCP 工具无覆盖的操作（更新 MR、编辑评论等） | 使用 aliyun CLI |
⚠️
aliyun devops ListRepositories已知存在SYSTEM_UNAUTHORIZED_ERROR问题，获取仓库 ID 优先用 MCP 工具。
常用操作对应
| 任务 | MCP 工具 | CLI 替代 |
|---|---|---|
| 查询仓库 | mcp__yunxiao__list_repositories | aliyun devops ListRepositories（可能报权限错误） |
| 创建 MR | mcp__yunxiao__create_change_request | aliyun devops CreateMergeRequest |
| 查看 MR | mcp__yunxiao__get_change_request | aliyun devops GetMergeRequest |
| 更新 MR | — | aliyun devops UpdateMergeRequest |
| 查询任务 | mcp__yunxiao__search_workitems | aliyun devops ListWorkitems |
| 获取任务详情 | mcp__yunxiao__get_work_item | — |
| 更新任务状态 | mcp__yunxiao__update_work_item | REST API（见 openapi.md） |
| 查询工作流 | mcp__yunxiao__get_work_item_workflow | aliyun devops ListWorkItemWorkFlowStatus |
| 添加评论 | mcp__yunxiao__create_work_item_comment | REST API（见 openapi.md） |
| 编辑评论 | — | aliyun devops UpdateWorkitemComment |
| 查询字段配置 | mcp__yunxiao__get_work_item_type_field_config | aliyun devops ListWorkItemAllFields |
| 创建 Tag | — | aliyun devops CreateTag |
Top 5 陷阱
最常踩的坑，完整规则见 cheatsheet.md：
- 仓库 ID 字段是
Id（大写 I） —jq用.id会返回null - 创建 MR 必须提供
sourceProjectId、targetProjectId、createFrom: "WEB" - 更新任务状态必须用 REST API —
aliyun devops POST /organization/.../workitems/updateWorkitemField updateWorkitemPropertyRequest必须是数组[{...}]，字段名用fieldIdentifier/fieldValue- 创建任务前必须查询必填字段 — 不同项目有不同的自定义必填字段
详细指南
- AI 助手必读: cheatsheet.md — 13 条黄金法则 + 完整错误速查表
- API 完整参考: openapi.md — 配置指南、所有 API 操作模板、MR/任务/发布完整工作流