yunxiao
Use this skill for all Alibaba Cloud 云效 (Yunxiao) DevOps operations on codeup.aliyun.com. Invoke IMMEDIATELY when the user wants to: create or manage Merge Requests (MR) on codeup, update work items/tasks in 云效, query MR lists or task status, create version tags via 云效 API, or push code to a codeup remote. Key triggers: 创建 MR, 提交评审, 云效, yunxiao, codeup, 更新任务, 查看任务, 发布版本, 打 tag. Handles both MCP tool mode and aliyun CLI fallback. Do NOT use for GitHub PRs (use git-workflow), Jira, GitLab, or non-Alibaba platforms.
How do I install this agent skill?
npx skills add https://github.com/niracler/skill --skill yunxiaoIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides technical guidance for AI agents to perform DevOps operations on Alibaba Cloud's Yunxiao (Codeup) platform using MCP tools or the official aliyun-cli. It contains no malicious patterns and follows standard configuration practices.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerwarn
2/3 files flagged
What does this agent skill do?
云效 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/任务/发布完整工作流
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/niracler/skill/yunxiao">View yunxiao on skillZs</a>