File contents 云效 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_repositoriesaliyun devops ListRepositories（可能报权限错误）
创建 MR
mcp__yunxiao__create_change_requestaliyun devops CreateMergeRequest
查看 MR
mcp__yunxiao__get_change_requestaliyun devops GetMergeRequest
更新 MR
—
aliyun devops UpdateMergeRequest
查询任务
mcp__yunxiao__search_workitemsaliyun devops ListWorkitems
获取任务详情
mcp__yunxiao__get_work_item—
更新任务状态
mcp__yunxiao__update_work_itemREST API（见 openapi.md）
查询工作流
mcp__yunxiao__get_work_item_workflowaliyun devops ListWorkItemWorkFlowStatus
添加评论
mcp__yunxiao__create_work_item_commentREST API（见 openapi.md）
编辑评论
—
aliyun devops UpdateWorkitemComment
查询字段配置
mcp__yunxiao__get_work_item_type_field_configaliyun 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/updateWorkitemFieldupdateWorkitemPropertyRequest 必须是数组[{...}]，字段名用 fieldIdentifier/fieldValue创建任务前必须查询必填字段 — 不同项目有不同的自定义必填字段
详细指南
AI 助手必读: cheatsheet.md — 13 条黄金法则 + 完整错误速查表API 完整参考: openapi.md — 配置指南、所有 API 操作模板、MR/任务/发布完整工作流
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1 --- 2 name: niracler-skill-yunxiao 3 description: 云效 CLI 4 --- 5 6 # 云效 CLI 7 8 阿里云云效 DevOps 命令行工具。记录了云效 API 的非显而易见的陷阱和必填字段规则，帮助一次调用成功。 9 10 ## Prerequisites 11 12 | Tool | Type | Required | Install | 13 |------|------|----------|---------| 14 | yunxiao MCP | mcp | No | Configure in Claude Code MCP settings (preferred over CLI) | 15 | aliyun CLI | cli | No | `brew install aliyun-cli` then `aliyun configure` — see [openapi.md](references/openapi.md) for full setup | 16 | git | cli | Yes | `brew install git` or [git-scm.com](https://git-scm.com/) | 17 | jq | cli | No | `brew install jq` (for JSON parsing in CLI mode) | 18 19 > At least one of yunxiao MCP or aliyun CLI is required. MCP is preferred. 20 > 21 > 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. 22 23 ## When to Use 24 25 - **创建/管理 MR**：在 codeup.aliyun.com 仓库上创建合并请求、更新描述、查看列表 26 - **任务管理**：查询/创建/更新任务状态、添加评论 27 - **发布管理**：通过云效 API 创建 Tag 28 29 ## 工具选择 30 31 | 条件 | 推荐方式 | 32 |------|----------| 33 | MCP 服务已连接（`mcp__yunxiao__*` 工具可用） | **优先使用 MCP 工具**（包括 MR 操作） | 34 | 无 MCP 服务 | 使用 `aliyun` CLI | 35 | MCP 工具无覆盖的操作（更新 MR、编辑评论等） | 使用 `aliyun` CLI | 36 37 > ⚠️ `aliyun devops ListRepositories` 已知存在 `SYSTEM_UNAUTHORIZED_ERROR` 问题，获取仓库 ID 优先用 MCP 工具。 38 39 ### 常用操作对应 40 41 | 任务 | MCP 工具 | CLI 替代 | 42 |------|----------|----------| 43 | 查询仓库 | `mcp__yunxiao__list_repositories` | `aliyun devops ListRepositories`（可能报权限错误） | 44 | 创建 MR | `mcp__yunxiao__create_change_request` | `aliyun devops CreateMergeRequest` | 45 | 查看 MR | `mcp__yunxiao__get_change_request` | `aliyun devops GetMergeRequest` | 46 | 更新 MR | — | `aliyun devops UpdateMergeRequest` | 47 | 查询任务 | `mcp__yunxiao__search_workitems` | `aliyun devops ListWorkitems` | 48 | 获取任务详情 | `mcp__yunxiao__get_work_item` | — | 49 | 更新任务状态 | `mcp__yunxiao__update_work_item` | REST API（见 openapi.md） | 50 | 查询工作流 | `mcp__yunxiao__get_work_item_workflow` | `aliyun devops ListWorkItemWorkFlowStatus` | 51 | 添加评论 | `mcp__yunxiao__create_work_item_comment` | REST API（见 openapi.md） | 52 | 编辑评论 | — | `aliyun devops UpdateWorkitemComment` | 53 | 查询字段配置 | `mcp__yunxiao__get_work_item_type_field_config` | `aliyun devops ListWorkItemAllFields` | 54 | 创建 Tag | — | `aliyun devops CreateTag` | 55 56 ## Top 5 陷阱 57 58 最常踩的坑，完整规则见 [cheatsheet.md](references/cheatsheet.md)： 59 60 1. **仓库 ID 字段是 `Id`（大写 I）** — `jq` 用 `.id` 会返回 `null` 61 2. **创建 MR 必须提供** `sourceProjectId`、`targetProjectId`、`createFrom: "WEB"` 62 3. **更新任务状态必须用 REST API** — `aliyun devops POST /organization/.../workitems/updateWorkitemField` 63 4. **`updateWorkitemPropertyRequest` 必须是数组** `[{...}]`，字段名用 `fieldIdentifier`/`fieldValue` 64 5. **创建任务前必须查询必填字段** — 不同项目有不同的自定义必填字段 65 66 ## 详细指南 67 68 - **AI 助手必读:** [cheatsheet.md](references/cheatsheet.md) — 13 条黄金法则 + 完整错误速查表 69 - **API 完整参考:** [openapi.md](references/openapi.md) — 配置指南、所有 API 操作模板、MR/任务/发布完整工作流 70 71 --- 72 > Converted and distributed by [TomeVault](https://tomevault.io/claim/niracler) — claim your Tome and manage your conversions. 73 <!-- tomevault:4.0:skill_md:2026-04-11 -->
commit ae2f9fdedc
Frequently asked questions How do I install the Niracler Skill Yunxiao skill? Run npx skillmds@latest add tomevault-io/niracler-skill-yunxiao in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Niracler Skill Yunxiao skill do? 云效 CLI It is listed under Coding & Dev Tools on SkillMD.
Is Niracler Skill Yunxiao safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Niracler Skill Yunxiao? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Niracler Skill Yunxiao free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Niracler Skill Yunxiao? tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io