This Claude skill integrates seamlessly with Alibaba Cloud DevOps (Yunxiao/云效), enabling developers to manage the entire software delivery lifecycle through automated CLI commands. It simplifies complex workflows across Codeup for code reviews, Projex for task tracking, and general release management, allowing users to execute Merge Requests, update work item statuses, and handle repository metadata without leaving their terminal or chat interface.

When should I use yunxiao-cli?

yunxiao-cli is useful in the following scenarios: • Automating the end-to-end Merge Request (MR) process: From extracting organization IDs and creating branches to pushing code and submitting the final review request to Codeup. • Efficient Task Management in Projex: Updating work item statuses to 'Completed', adding Markdown-formatted comments, and querying task lists using optimized REST API calls. • Streamlining DevOps Metadata Retrieval: Quickly fetching Organization, Project, and Repository IDs required for Alibaba Cloud API operations using pre-configured jq filters. • Release and Version Control: Managing release tags and versioning by automating git tag creation and pushing updates to remote Alibaba Cloud repositories. • Troubleshooting DevOps Workflows: Utilizing a comprehensive error-reference guide to resolve common API issues related to JSON parsing, missing parameters, or permission levels.

name	yunxiao-cli
description	Use when working with Alibaba Cloud DevOps (Yunxiao/云效), including Codeup code review (MR/PR), release tags, or Projex tasks.

云效 CLI

阿里云云效 DevOps 命令行工具。涵盖代码评审、发布管理和任务跟踪。

创建 MR 完整流程（最常用）

一键执行，无需额外查询。 适用于：用户说"创建 MR"、"提交代码评审"、"推送分支并创建 MR"。

步骤 1：提取 ID（从 git remote 自动获取）

# 从 git remote 提取组织 ID
ORG_ID=$(git remote get-url origin | sed -E 's|.*codeup.aliyun.com[:/]([^/]+)/.*|\1|')
echo "组织 ID: $ORG_ID"

# 从 git remote 提取仓库名
REPO_NAME=$(basename -s .git $(git remote get-url origin))
echo "仓库名: $REPO_NAME"

# 获取仓库 ID（⚠️ 注意：字段是大写 Id，不是 id）
REPO_ID=$(aliyun devops ListRepositories --organizationId $ORG_ID \
  | jq -r ".result[] | select(.name == \"$REPO_NAME\") | .Id")
echo "仓库 ID: $REPO_ID"

步骤 2：创建分支、提交、推送

# 创建并切换分支
git checkout -b feature/your-feature

# 添加改动并提交
git add .
git commit -m "feat: your commit message"

# 推送分支到远程
git push -u origin feature/your-feature

步骤 3：创建 MR

aliyun devops CreateMergeRequest \
  --organizationId $ORG_ID \
  --repositoryId $REPO_ID \
  --body '{
    "title": "feat: your MR title",
    "description": "## Summary\n\n- Change 1\n- Change 2",
    "sourceBranch": "feature/your-feature",
    "targetBranch": "main",
    "sourceProjectId": '$REPO_ID',
    "targetProjectId": '$REPO_ID',
    "createFrom": "WEB"
  }'

⚠️ 关键点：

仓库 ID 字段是 Id（大写 I），不是 id
sourceProjectId、targetProjectId、createFrom: "WEB" 三个字段必须提供

已知 ID 速查表

首次使用前必须获取这些 ID，后续可直接复用：

# 获取组织 ID（必须加 --minAccessLevel 5）
aliyun devops ListOrganizations --minAccessLevel 5 \
  | jq -r '.result[] | "\(.organizationId): \(.organizationName)"'

# 获取项目 ID
aliyun devops ListProjects --organizationId <org-id> --category Project \
  | jq -r '.projects[] | "\(.identifier): \(.name)"'

# 获取任务类型 ID
aliyun devops ListProjectWorkitemTypes \
  --organizationId <org-id> --projectId <project-id> \
  --category Task --spaceType Project \
  | jq -r '.workitemTypes[] | "\(.identifier): \(.name)"'

# 获取状态 ID 列表
aliyun devops ListWorkItemWorkFlowStatus \
  --organizationId <org-id> \
  --spaceIdentifier <project-id> \
  --spaceType Project \
  --workitemTypeIdentifier <task-type-id> \
  --workitemCategoryIdentifier Task \
  | jq -r '.statuses[] | "\(.identifier): \(.name)"'

常见状态 ID（大多数项目通用）：

状态	identifier
待处理	`100005`
处理中	`100010`
已完成	`100014`

任务管理（一次成功模板）

查看任务列表

aliyun devops ListWorkitems \
  --organizationId <org-id> \
  --spaceIdentifier <project-id> \
  --spaceType Project \
  --category Task \
  | jq -r '.workitems[] | "\(.identifier): \(.subject) [\(.status)]"'

更新任务状态为"已完成"

⚠️ 必须用 REST API 方式（aliyun devops POST /path），不能用命令行参数方式

aliyun devops POST /organization/<org-id>/workitems/updateWorkitemField \
  --body '{
    "workitemIdentifier": "<workitem-id>",
    "updateWorkitemPropertyRequest": [
      {"fieldIdentifier": "status", "fieldValue": "100014"}
    ]
  }'

关键点：

updateWorkitemPropertyRequest 必须是数组 [{...}]
字段名是 fieldIdentifier 和 fieldValue（不是 propertyKey/propertyValue）

添加任务评论

aliyun devops POST /organization/<org-id>/workitems/comment \
  --body '{
    "workitemIdentifier": "<workitem-id>",
    "content": "## 评论标题\n\n评论内容，支持 Markdown",
    "formatType": "MARKDOWN"
  }'

关键点： formatType 必须指定（MARKDOWN 或 RICHTEXT）

完整示例：完成任务并添加评论

ORG_ID="<your-org-id>"
WORKITEM_ID="<your-workitem-id>"

# 1. 更新状态为已完成
aliyun devops POST /organization/${ORG_ID}/workitems/updateWorkitemField \
  --body "{
    \"workitemIdentifier\": \"${WORKITEM_ID}\",
    \"updateWorkitemPropertyRequest\": [
      {\"fieldIdentifier\": \"status\", \"fieldValue\": \"100014\"}
    ]
  }"

# 2. 添加完成评论
aliyun devops POST /organization/${ORG_ID}/workitems/comment \
  --body "{
    \"workitemIdentifier\": \"${WORKITEM_ID}\",
    \"content\": \"## 实现完成\\n\\n- 功能已实现\\n- 测试已通过\",
    \"formatType\": \"MARKDOWN\"
  }"

MR 管理

创建 MR

确保分支已推送：git push -u origin <branch>
使用 aliyun CLI 创建 MR（见 cheatsheet.md 模板）

快速模板：

aliyun devops CreateMergeRequest \
  --organizationId <org-id> \
  --repositoryId <repo-id> \
  --body '{
    "title": "feat: your title",
    "sourceBranch": "<your-branch>",
    "targetBranch": "main",
    "sourceProjectId": <repo-id>,
    "targetProjectId": <repo-id>,
    "createFrom": "WEB"
  }'

关键点： sourceProjectId, targetProjectId, createFrom: "WEB" 都必须提供

更新已有 MR

git push origin <branch>  # MR 自动更新

查看 MR 列表

见 cheatsheet.md 模板

创建任务

aliyun devops CreateWorkitem \
  --organizationId <org-id> \
  --body '{
    "subject": "任务标题",
    "space": "<project-id>",
    "spaceIdentifier": "<project-id>",
    "spaceType": "Project",
    "category": "Task",
    "workitemType": "<task-type-id>",
    "workitemTypeIdentifier": "<task-type-id>",
    "assignedTo": "<user-id>",
    "fieldValueList": [
      {"fieldIdentifier": "<field-id>", "value": "<value>"}
    ]
  }'