关于 yunxiao
yunxiao 是面向云效 DevOps 操作的命令行技能，提供 API 调用指南及常见陷阱说明。可借助云效 MCP 或 aliyun CLI 管理合并请求、任务和发布标签。
主要功能
- 01创建、查看和管理合并请求
- 02查询及更新任务和评论
- 03通过 API 创建 Tag
- 04说明必填字段与调用陷阱
适用场景
- 01在 Codeup 仓库创建或检查合并请求
- 02查询任务并更新任务状态
- 03创建发布 Tag 时参考 API 模板
MCP 相关
可优先使用云效 MCP 执行支持的仓库、合并请求和任务操作；未覆盖的操作可通过 aliyun CLI 完成。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/yunxiao确认已加载。
附带文件references/cheatsheet.mdreferences/openapi.md
详细介绍
来自项目 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/任务/发布完整工作流
评论
支持 Markdown