yunxiao について
yunxiao は Alibaba Cloud Yunxiao DevOps 向けのコマンドラインスキルで、API の必須項目や注意点を案内します。Yunxiao MCP または aliyun CLI を使い、マージリクエスト、作業項目、リリースタグを管理できます。
主な機能
- 01マージリクエストの作成・確認・管理
- 02作業項目とコメントの検索・更新
- 03API によるタグ作成
- 04必須項目と API の注意点を案内
活用シーン
- 01Codeup リポジトリでマージリクエストを作成・確認
- 02作業項目を検索してステータスを更新
- 03リリースタグ作成時に API テンプレートを参照
MCP 対応
対応するリポジトリ、マージリクエスト、作業項目の操作には Yunxiao MCP を優先します。MCP で対応していない操作には aliyun CLI を使えます。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/yunxiaoを入力して読み込まれたか確認します。
同梱ファイルreferences/cheatsheet.mdreferences/openapi.md
詳細
云效 CLI
Alibaba Cloud 云效 DevOps コマンドラインツールです。云效 API の見落としやすい落とし穴と必須フィールドのルールを記録し、1 回の呼び出しで成功できるよう支援します。
前提条件
| ツール | 種類 | 必須 | インストール |
|---|---|---|---|
| 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 を使って 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 |
よくある落とし穴トップ 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 対応