云效 CLI
阿里云云效 DevOps 命令行工具。记录了云效 API 的非显而易见的陷阱和必填字段规则，帮助一次调用成功。
前提条件
| ツール | タイプ | 必須 | インストール方法 |
|---|---|---|---|
| yunxiao MCP | mcp | いいえ | Claude Code MCP 設定で構成（CLI よりも推奨） |
| aliyun CLI | cli | いいえ | brew install aliyun-cli 然后 aliyun configure — 完整设置请参见 openapi.md |
| git | cli | はい | brew install git 或 git-scm.com |
| jq | cli | いいえ | brew install jq（CLI 模式下 JSON 解析用） |
yunxiao MCP と aliyun CLI の少なくとも一方が必要です。MCP を推奨します。
スキル読み込み時にこれらのツールを積極的に確認しないでください。コマンドがツール不足で失敗した場合、ユーザーにインストールと設定をステップバイステップで直接案内してください。
使用タイミング
- MR の作成/管理: codeup.aliyun.com リポジトリでのマージリクエスト作成、説明更新、一覧表示
- タスク管理: タスクステータスの照会/作成/更新、コメントの追加
- リリース管理: 云效 API を使用したタグ作成
ツール選択
| 条件 | 推奨方法 |
|---|---|
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 |
| タグ作成 | — | aliyun devops CreateTag |
落とし穴トップ 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/タスク/リリースの完全ワークフロー