alibabacloud-devops について
コード、パイプライン、プロジェクト協業を扱うチーム向けに、自然言語の DevOps 要求を Alibaba Cloud Yunxiao API 操作へ変換するスキルです。意図の分類と製品への対応付けを行い、Alibaba Cloud CLI、MCP サーバー、mcporter から実行できます。
主な機能
- 01CI/CD、コード、プロジェクト協業に対応
- 02成果物、テスト、アプリケーション配信を支援
- 03意図を分類して Yunxiao 製品へ対応付け
- 04曖昧さを解消し実行前にパラメーターを確認
- 05CLI、MCP、mcporter による呼び出し
活用シーン
- 01リポジトリやブランチの照会・管理
- 02パイプラインやアプリケーション配信の起動
- 03スプリントや作業項目の作成・追跡
MCP 対応
MCP サーバー経由で Yunxiao ツールを呼び出せます。Alibaba Cloud CLI が利用できない場合の代替呼び出しチャネルです。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aliyun/ alibabacloud-aiops-skills --skill alibabacloud-devopsインストール後、Claude Code で/alibabacloud-devopsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/acceptance-criteria.mdaliyun-cli-install.mdaliyun-cli-setup.mdcommon-scenarios.mdintent-classification.mdmcp-setup.mdproduct-mapping.mdproduct-reference.mdram-policies.mdtoken-scopes.mdtool-catalog.mdverification-method.mdscripts/check-environment.shdiscover-commands.shmcporter-call.sh詳細
Yunxiao ツールによるインテリジェントな DevOps 実行
このスキルは、自然言語による DevOps のリクエストを Alibaba Cloud Yunxiao API 呼び出しに変換します。Alibaba Cloud CLI(aliyun devops)、MCP サーバー、mcporter CLI の 3 つの呼び出しチャネルに対応しています。Yunxiao の 8 製品(CLI コマンド約 388 個、MCP ツール約 165 個)を網羅しています。
1. 概要
- 主なフロー:意図の分類 → あいまいさの解消 → 製品のマッピング → リファレンスの確認 → ツールの実行 → 結果の検証
- 対象範囲:CI/CD、コード管理、プロジェクトコラボレーション、スプリント/作業項目、成果物、テスト、アプリケーション配信
製品およびツールの全カタログ(製品ごとの MCP ツールと CLI コマンド)については、references/tool-catalog.md を参照してください。
2. 前提条件
[MUST] 実行順序は必須です。 このセクションの手順は、順番に従って判断する決定木を構成しています。以下の番号順に必ず実行してください。CLI の手順(ステップ 1~4)をすべて試して失敗するまで、Node.js、MCP、または mcporter が利用可能かどうかを確認しないでください。サブセクション 2.1 と 2.2 の確認を並行して実行しないでください。
トークンのセキュリティルール(すべてのチャネルに適用):
- 会話やコマンドラインに平文のトークンを貼り付けるようユーザーに求めることは絶対にしないでください
echoなどのコマンドでトークンの値を読み取ったり、表示したりすることは絶対にしないでください- 確認によってトークンの存在のみを検証してください(チャネルごとの環境変数名は以下の手順を参照)
- トークンが設定されていない場合は中止し、ユーザーにYunxiao Personal Access Tokenへの案内をしてください。必要なスコープ:Organization Management(R/W)、Project Collaboration(R/W)、Code Management(R/W)、Pipeline(R/W)、Packages(R/W)、Application Delivery(R/W)、Test Management(R/W)。
2.1 CLI チャネルのセットアップ(最優先 — 最初に必ず完了してください)
Alibaba Cloud CLI(
aliyun devops)は主要な呼び出しチャネルです。MCP Server と mcporter はフォールバックとしてのみ使用します。設定ガイドの全文はこちらです:references/aliyun-cli-setup.md。
ステップ 1:CLI の利用可否を確認
aliyun devops --help >/dev/null 2>&1 && echo "cli ready" || echo "cli not available"
- 利用可能 → ステップ 3へ進みます
- 利用不可 → ステップ 2へ進みます(インストールを試みます)
ステップ 2:[必須] CLI のインストールを試みる
[必須] ステップ 1 で CLI が見つからなかった場合、フォールバックチャネルを検討する前に、必ずインストールを試みてください。このステップを省略することは禁止されています。インストールガイドの全文はこちらです:references/aliyun-cli-install.md。
-
OS を検出してインストールします:
- macOS(Homebrew が利用可能):
brew install aliyun-cli - macOS / Linux(Homebrew がない場合):
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" - Windows(PowerShell): PowerShell のインストールスクリプトをダウンロードして実行するようユーザーに案内します。references/aliyun-cli-install.mdを参照してください。
- macOS(Homebrew が利用可能):
-
インストールを確認し、再チェックします:
aliyun version aliyun devops --help >/dev/null 2>&1 && echo "cli ready" || echo "cli not available"- 利用可能 → ステップ 3へ進みます
- まだ利用不可 → セクション 2.2 フォールバックへ進みます
ステップ 3:認証とサイト種別の検出
Cloud DevOps(Yunxiao)では、認証に AK/SK プロファイルではなく、パーソナルアクセストークンを使用します。
3a. トークンを確認:
[ -n "$ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN" ] && echo "token configured" || echo "token missing"
トークンがない場合は、サイト種別に応じた設定方法をユーザーに案内します。
中央サイト(デフォルト)— トークン + 組織 ID:
export ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN=<your-personal-access-token>
export ALIBABA_CLOUD_YUNXIAO_ORGANIZATION_ID=<your-organization-id>
リージョンサイト — トークン + リージョン API ベース URL:
export ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN=<your-personal-access-token>
export ALIBABA_CLOUD_YUNXIAO_API_BASE_URL=<your-region-api-base-url>
[必須] 中央サイトでは API ベース URL をユーザーに尋ねないでください — デフォルトは
openapi-rdc.aliyuncs.comです(CLI と MCP Server の両方)。ベース URL の設定が必要なのはリージョンサイトのみです。
これらをユーザーのシェルプロファイル(~/.bashrc、~/.zshrc など)に追加して、設定を永続化することを推奨します。
3b. サイト種別を検出:
トークンを確認した後、サイト種別を検出します。
[ -n "$ALIBABA_CLOUD_YUNXIAO_API_BASE_URL" ] && echo "region site" || echo "central site (default)"
[ -n "$ALIBABA_CLOUD_YUNXIAO_ORGANIZATION_ID" ] && echo "org id configured" || echo "org id missing"
ALIBABA_CLOUD_YUNXIAO_API_BASE_URLが設定されている → リージョンサイト:以降の CLI 呼び出しでは--organization-idを使用しません。API ベース URL は環境変数から自動的に読み込まれます- 設定されていない → 中央サイト(デフォルト):以降の CLI 呼び出しでは
--organization-idを使用します。組織 ID が設定されていない場合は、ALIBABA_CLOUD_YUNXIAO_ORGANIZATION_IDを設定するようユーザーに案内します(aliyun devops base-get-user-by-tokenで確認できます)
[必須] 検出したサイト種別を記憶してください。このセッションでの以降の CLI 呼び出しでは、対応するパラメーター形式を使用する必要があります。CLI パラメーターは kebab-case(例:
--organization-id)を使用し、camelCase(--organizationId)は使用しません。
ステップ 4:[必須] 対話式のプラグインインストールプロンプトを無効にする
devops コマンドは aliyun-cli-devops プラグインに含まれていますが、このプラグインは新規 CLI インストールにはバンドルされていません。そのため、最初の aliyun devops <business-command> の実行時に Do you want to install it? [Y/n]: と尋ねられ、コマンドがタイムアウトするまで処理が停止します。ビジネスコマンドを実行する前に、セッションごとに一度実行してください。
aliyun configure set --auto-plugin-install true
このステップを省略すると、最初のビジネス呼び出しでタイムアウトの割り当て時間をすべて無駄にします。
CLI の準備完了 — ステップ 1〜4 がすべて成功した場合、CLI チャネルの準備は完了です。セクション 2.2 は完全にスキップし、セクション 3 に進んでください。
2.2 フォールバックチャネルのセットアップ(CLI が利用できない場合のみ)
[条件] このセクションに進めるのは、次の両方の条件を満たす場合に限ります。
- ステップ 1(CLI の確認)で「cli not available」と返された
- ステップ 2(CLI のインストール試行)を実行したが失敗した
ステップ 2 をまだ試していない場合は、戻って今すぐ実行してください。ここには進まないでください。
2.2.1 Node.js/Docker ランタイムの確認
このスキルは npx または docker を介して [email protected] を呼び出します。次を確認してください。
node --version # Node.js 18+ recommended
npx --version
推奨:依存関係を事前にインストール(ランタイムでのダウンロードを回避)
npm install -g [email protected] [email protected] --registry=https://registry.npmmirror.com
2.2.2 Yunxiao のパーソナルアクセストークン(MCP/mcporter 用)
MCP/mcporter では YUNXIAO_ACCESS_TOKEN を使用します(CLI の ALIBABA_CLOUD_YUNXIAO_ACCESS_TOKEN とは異なります)。
[ -n "$YUNXIAO_ACCESS_TOKEN" ] && echo "token configured" || echo "token missing"
トークンがない場合は、ユーザーにトークンの取得方法を案内し、環境変数として設定してください(セクション 2 の冒頭にある「トークンのセキュリティルール」を参照)。
2.2.3 MCP サーバーのセットアップ
3 つの接続モード(Stdio/Docker/SSE)については、references/mcp-setup.md を参照してください。推奨は Stdio です。
{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": ["-y", "[email protected]"],
"env": {
"YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
中央サイトではトークンのみが必要です。
YUNXIAO_API_BASE_URLのデフォルト値はhttps://openapi-rdc.aliyuncs.comです。リージョンサイトの場合に限り、envに追加してください。
3. 認可エラーへの対応
[MUST] いずれかのツール呼び出しで認証/認可エラーが返された場合:
- 必要なトークンスコープについて、references/token-scopes.md を参照します
- Yunxiao コンソールの「Personal Access Token」でスコープを追加するよう、ユーザーに案内します
- 実行を一時停止し、続行する前にユーザーの確認を待ちます
一般的なエラーコード:
| エラー | 対応 |
|---|---|
| 401 Authentication failed | トークンが有効か、有効期限が切れていないか確認し、再生成を促します |
| 403 Insufficient permissions | トークンスコープを確認します(token-scopes.md および references/ram-policies.md を参照) |
| 404 Resource not found | search_*/list_* を使用して、リソース ID を確認します |
| 400 Parameter error | MCP Schema に照らしてフィールドスキーマを確認します |
| 500 Server error | バックオフを入れて最大 3 回再試行します |
4. パラメーターの確認
IMPORTANT — ツール呼び出しを実行する前に、ユーザーが指定するすべてのパラメーター(organizationId、projectId、repositoryId、pipelineId、ブランチ名、作業項目の件名、スプリントの日付、アプリ/環境名など)を必ずユーザーに確認してください。デフォルト値や推測に基づいて呼び出してはいけません。
製品ごとに一般的に必要なパラメーター:
| 製品 | 共通必須項目 | 代表的なシナリオのパラメーター |
|---|---|---|
| すべて | organizationId | - |
| Codeup | repositoryId | sourceBranch/targetBranch/filePath |
| Flow | pipelineId | branch/runId/jobId |
| Projex | projectId | workitemTypeId/sprintId/subject |
| Testhub | projectId | testcaseId/testPlanId |
| AppStack | appName | envName/changeOrderId |
5. 基本的な実行フロー
User request → [Step 1] Intent classification → [Step 2] Ambiguity handling → [Step 3] Product mapping
→ [Step 4] Read product references → [Step 5] Execute tool calls → Return results
ステップ 1:意図の分類
基本原則:名詞ではなく、中心となる動詞を特定します。
| 操作 | 代表的な動詞 | ツールのプレフィックス |
|---|---|---|
| 作成 | create、add、initialize、set up | create_* |
| 検索 | view、get、list、search、find | get_*/list_*/search_* |
| 更新 | update、modify、change、edit | update_* |
| 削除 | delete、remove、clean up | delete_*(確認が必要) |
| 実行 | run、execute、trigger、start、deploy | create_pipeline_run/execute_* |
| 設定 | configure、set up、bind、associate | update_*/create_* |
判断ツリーと例については、references/intent-classification.md を参照してください。
ステップ 2:曖昧さへの対応
基本原則:指示が曖昧な場合や、複数製品に関するキーワードが含まれる場合は、決して推測せず、質問してください。
| 曖昧さの種類 | 検出条件 | 対応方針 |
|---|---|---|
| 製品 | 複数製品に関するキーワードがある | どの製品かを尋ねます |
| 操作 | 操作が不明確 | 操作の種類を尋ねます |
| 対象 | 識別子が不足している | リソース名または ID を尋ねます |
| パラメーター | 主要なパラメーターが不足している | 不足している値を尋ねます |
| スコープ | 組織/プロジェクトが指定されていない | 組織/プロジェクトを尋ねます |
ステップ 3:製品のマッピング
マッピングの全容:references/product-mapping.md。
| キーワード | 製品 | MCP ツールセット | CLI プレフィックス |
|---|---|---|---|
| パイプライン、ビルド、デプロイ、CI/CD | Flow | pipeline-management | flow- |
| コード、リポジトリ、ブランチ、コミット、MR、レビュー | Codeup | code-management | codeup- |
| アーティファクト、パッケージ、Maven、NPM、Docker イメージ | Packages | packages-management | packages- |
| 要件、作業項目、スプリント、バグ、タスク | Projex | project-management | projex- |
| テストケース、テスト計画、テストレポート | Testhub | test-management | test-hub- |
| アプリケーション、オーケストレーション、変更オーダー、リリース | AppStack | application-delivery | app-stack- |
| 組織、メンバー、部門、ロール | - | organization-management | base- |
| 現在のユーザー情報 | - | base | base- |
判断が曖昧な場合:
- 「CI/CD の全フロー」→ ビルドのみ → Flow、アプリケーションのライフサイクル → AppStack、両方 → 確認する
- 「リポジトリ」→ コードリポジトリ → Codeup、アーティファクトリポジトリ → Packages、不明確 → 確認する
ステップ 4:製品リファレンスを読む
対象製品を特定した後、references/product-reference.md にある Yunxiao のドキュメントインデックスを必ず参照してください。
ステップ 5:ツール呼び出しを実行する
3 つの呼び出しチャネル(機能的に同等):
| 方法 | シナリオ | 前提条件 |
|---|---|---|
Alibaba Cloud CLI(aliyun devops) | シェル環境を利用可能 | トークンを設定した状態で aliyun をインストール済み |
| プラットフォームネイティブの MCP | MCP サーバーを備えた IDE/プラットフォーム | use_mcp_tool を利用可能 |
| ターミナル CLI(mcporter) | MCP サーバーのないターミナル環境 | Node.js 18+ をインストール済み |
チャネルの選択:利用可能な環境に応じて選択してください。CLI が設定済みなら CLI、MCP が統合済みなら MCP、シェルと Node.js のみなら mcporter を使用します。
リージョンサイトのルーティング(必須):ユーザーが現在の MCP 設定と異なる Yunxiao インスタンスのアドレスまたはトークンを指定した場合:
- MCP サーバー設定(
YUNXIAO_API_BASE_URL/YUNXIAO_ACCESS_TOKEN)の更新をユーザーに必ず促してください - mcporter を介して MCP サーバーを迂回してはなりません。mcporter は MCP サーバーが存在しない場合にのみ使用します
- リージョンのキーワード(例:
cn-shanghai)を含む URL はリージョン版です。openapi-rdc.aliyuncs.comまたは指定なしの場合は中央版です(デフォルト。ベース URL の設定は不要)
方法 A:Alibaba Cloud CLI
aliyun devops <command> --<param1> <value1> \
--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-devops/${SESSION_ID}"
すべての
aliyun devopsコマンドには、セッションスコープの UA 値を指定する--user-agentを必ず含めてください(セクション 7「可観測性」を参照)。認証に環境変数を使用する場合、追加の認証パラメーターは不要です。コマンドラインパラメーターを使用する場合は、各コマンドに--yunxiao-access-tokenと--organization-id(中央版)または--api-base-url(リージョン版)を追加してください。
製品プレフィックスでコマンドを検索するには、scripts/discover-commands.sh を使用するか、references/tool-catalog.md を参照してください。
方法 B:プラットフォームネイティブの MCP
use_mcp_tool(
server_name: "yunxiao",
tool_name: "<tool>",
arguments: { "<key>": "<value>" }
)
方法 C:mcporter CLI
npx -y [email protected] call --no-coerce --stdio "npx -y [email protected]" <tool_name> [key:"value" ...]
文字列の列挙値が自動的に型変換されるのを防ぐため、常に
--no-coerceを使用する必要があります。
パラメーターのルール:key:"value" 形式をスペース区切りで使用してください。JSON 文字列は渡さないでください。引数を取らないツールにはパラメーターを指定しないでください。利便性のため、scripts/mcporter-call.sh を使用してください。
利用可能なツールを取得する:
npx -y [email protected] list --stdio "npx -y [email protected]" --schema
[MUST] ツールの選択は動的な検出に基づく必要があります:登録済みツールの一覧から選択し、ツール名を捏造しないでください。
mcporter listまたは references/tool-catalog.md を使用してください。
[MUST] 結果を決して捏造しないでください:すべてのツール呼び出しは、実際の戻り値を伴って実行する必要があります。
実行前チェックリスト(必須):
aliyun devops base-get-user-by-tokenを使用してorganizationIdを取得します(MCP の場合はget_current_organization_info)- [必須] ID が指定されている場合も含め、
list_*/search_*/get_*を使用して対象リソースの存在を確認します - 必須パラメーターをすべてユーザーに確認します(セクション 4)
- 削除操作には確認が必要です
- [必須] 不慣れなツールを初めて呼び出す前に、スキーマを動的に検証します:
- 方法 B:プラットフォームのツールレジストリを確認します
- 方法 C:
npx -y [email protected] list --stdio "npx -y [email protected]" --schema 2>&1 | grep -A 30 'function <tool_name>' - スキーマで異なるツール名が返された場合は、スキーマに記載された名前を使用します
- Testhub の場合:最初に
test-hub-get-testcase-field-config(MCP の場合はget_testcase_field_config)を呼び出してください。必須フィールド(assignedToが該当します)と、customFieldValuesに設定する必要があるライブラリごとのオプション IDが返されます(例:{"tc.priority": "<P1 option id>"}。ラベル"P1"を送ると400 字段【优先级】所填值无效エラーになります)。testStepsにはcontent[]配列が必要です。stepContent/expectedResult(読み取り時の形式)のみを含むペイロードは500 unknown exceptionエラーになります。references/common-scenarios.md のシナリオ 6 を参照してください。 - Projex の場合:最初に
projex-list-workitem-types(MCP の場合はlist_work_item_types)を呼び出してください。ハードコードされたタイプ ID は決して使用しないでください
ツールカタログ全体:references/tool-catalog.md。シナリオの例:references/common-scenarios.md。
6. 成功の確認
[RECOMMENDED]
create_*/update_*の実行後、予算が許す場合は対応するget_*を呼び出して確認してください。API がリソース ID とともに成功を返した場合は、読み戻しを行わなくても作成は成功したと見なせます。既知の API の制限事項:書き込み時と読み戻し時で一部のフィールドが異なる場合があります。references/verification-method.md を参照してください。
| 操作 | 確認コマンド(CLI/MCP) | 確認内容 |
|---|---|---|
| パイプラインを作成 | flow-get-pipeline(MCP:get_pipeline) | pipelineId と name が一致 |
| パイプラインを実行 | flow-get-latest-pipeline-run(MCP:get_latest_pipeline_run) | status != FAIL |
| ブランチを作成 | codeup-get-branch(MCP:get_branch) | ブランチが表示される |
| MR を作成 | codeup-get-change-request(MCP:get_change_request) | state = OPENED |
| 作業項目を作成 | projex-get-workitem(MCP:get_work_item) | subject と workItemTypeId が正しい |
| スプリントを作成 | projex-get-sprint(MCP:get_sprint) | 日付範囲が一致 |
詳細:references/verification-method.md。
7. オブザーバビリティ
User-Agent の宣言(必須)
[MUST] すべての
aliyun devopsビジネスコマンドには、帰属の特定とトレースのために--user-agentフラグを付ける必要があります。UA 値は、セッションごとの識別子を含む固定テンプレートに従います。
UA テンプレート:
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-devops/{session-id}
Session-ID の生成ルール:
| 項目 | ルール |
|---|---|
| 形式 | 32 文字の小文字の 16 進数文字列(例:f47ac10b58cc4372a5670e02b2c3d479) |
| ライフサイクル | 各スキル呼び出しセッションの開始時に一度だけ生成し、そのセッション内のすべてのチャネル(CLI、MCP、mcporter)で同じ値を再利用します |
| 一貫性 | 1 つのセッション内では、同じ {session-id} を CLI の --user-agent、MCP リクエストのメタデータ、mcporter の呼び出しに使用する必要があります |
| 生成方法 | python3 -c "import uuid; print(uuid.uuid4().hex)" または uuidgen | tr -d '-' | tr '[:upper:]' '[:lower:]' |
使用方法 — すべての aliyun devops コマンドに追加します:
SESSION_ID=$(python3 -c "import uuid; print(uuid.uuid4().hex)")
aliyun devops <command> --<param1> <value1> \
--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-devops/${SESSION_ID}"
重要:
--user-agentフラグは、各ビジネスコマンドに直接適用します。グローバルなモード設定コマンドで UA を設定してはいけません。呼び出しごとに必ずインラインで指定してください。
8. ベストプラクティス
- 書き込み前に読み取る:現在の状態を確認するため、
update_*/delete_*の前にget_*を実行します - ページネーション:一覧 API はデフォルトでページネーションされます。大きな一覧では
page/perPageを指定します - まず YAML を用意する:パイプラインの作成には
flow-create-pipeline --name --contentを使用します(YAML は必須です)。YAML を作成する前に、推測した場合に必ず拒否される、組織固有の次の 3 つの値を収集します。リポジトリのhttpUrlToRepo(webUrlは使用しない)、Codeup サービス接続のuuid(小文字のフィルター--service-connection-type codeupを指定して検索します。Codeupでは再現性をもって空の一覧が返されますが、接続が存在しないことの証明にはなりません)、既存のパイプラインから取得したrunsOn.group(ビルドクラスターを一覧表示する API はなく、public/<region>が存在しない場合もよくあります)。Codeup の認証情報は、serviceConnectionキー単体ではなく、ネストされたcertificateオブジェクトです。また、ビルドのみのパイプラインではArtifactUploadを省略する必要があります。MCP のcreate_pipeline_from_descriptionは YAML を内部で作成し、修正できません。yaml校验失败/服务连接[...]不存在エラーが発生した場合は、再試行をやめて CLI の手順に切り替えてください。検証済みのテンプレートと事前確認の手順については、references/common-scenarios.md のシナリオ 1 を参照してください。 - スマート検索:タイムスタンプのパラメーターを指定した
flow-list-pipelinesでは、--execute-start-time/--execute-end-time/--create-start-time/--create-end-timeにミリ秒単位のエポック値(13 桁。例:$(($(date +%s) * 1000)))を指定します。秒単位の値(10 桁)は API に拒否されず、1970 年を基準にフィルターが適用されて誤解を招く結果が返されるため、必ず 1000 を掛けて、桁数が正しいことを確認してください。(MCP には、自然言語による時間範囲指定に対応したsmart_list_pipelinesがあります。) - まず読み取り専用で操作する:判断に迷った場合は、
list_*/search_*/get_*を使用します - すばやく見切る:同じパラメーターで 2 回連続して失敗したら、別の方法に切り替えます。報告する内容:試した方法、エラー、根本原因、次の手順
- 予算を守る:まずクリティカルパスを計画します。デバッグは 3 ステップ以内にします。上限が近い場合(残り 2 以下)は、そこで停止して報告します
- 後片付けをする:実験用のリソースは使用後に削除します
9. シナリオのクイックリファレンス
完全な例については、references/common-scenarios.mdを参照してください。
| シナリオ | 製品 | 主な CLI コマンド | 主な MCP ツール |
|---|---|---|---|
| Java ビルドパイプラインを作成する | Flow | codeup-get-repository(クローン URL)→ flow-list-service-connections --service-connection-type codeup(uuid。小文字の値を指定します。Codeupでは[]が返されます)→ flow-get-pipeline(runsOnを取得)→ flow-create-pipeline → flow-list-pipelines | get_repository → list_service_connections → get_pipeline → create_pipeline_from_description(YAML の検証に失敗した場合は CLI にフォールバックします) |
| レビューコメント付きの MR を作成する | Codeup | codeup-get-repository → codeup-create-change-request → codeup-list-change-request-patch-sets → codeup-create-change-request-comment | get_repository → create_change_request → list_change_request_patch_sets → create_change_request_comment |
| スプリントを作成して要件を追加する | Projex | projex-search-projects → projex-create-sprint → projex-create-workitem | search_projects → create_sprint → create_work_item |
| パイプラインを実行してログを表示する | Flow | flow-get-pipeline → flow-create-pipeline-run(ブランチは--params '{"branchModeBranchs":"<branch>"}'で指定します。--branchフラグはありません)→ flow-get-pipeline-run --pipeline-run-id → flow-get-pipeline-job-run-log --job-id <stages[].stageInfo.jobs[].id> | get_pipeline → create_pipeline_run → get_pipeline_run → get_pipeline_job_run_log |
| アーティファクトを一括で照会する | Packages | packages-list-repositories → packages-list-artifacts | list_package_repositories → list_artifacts |
| テストケースを作成する | Testhub | test-hub-get-testcase-field-config(必須フィールドとオプション ID)→ test-hub-list-directories → test-hub-create-testcase → test-hub-search-testcases | get_testcase_field_config → list_testcase_directories → create_testcase → search_testcases |
| アプリケーションのリリースワークフロー | AppStack | app-stack-list-all-release-workflows → app-stack-execute-change-request-release-stage | list_app_release_workflows → execute_app_release_stage |
10. リファレンス一覧
| リファレンスファイル | 内容 |
|---|---|
| references/aliyun-cli-install.md | Alibaba Cloud CLI のインストールガイド(macOS/Linux/Windows) |
| references/mcp-setup.md | MCP サーバーの接続モードと環境変数 |
| references/intent-classification.md | インテント分類の判断ツリー |
| references/product-mapping.md | キーワード → 製品の対応表 |
| references/product-reference.md | Yunxiao のドキュメント一覧と主要な概念 |
| references/tool-catalog.md | 約165個の MCP ツールを分類したカタログ |
| references/token-scopes.md | トークンの認可スコープとトラブルシューティング |
| references/common-scenarios.md | エンドツーエンドのワークフロー例 |
| references/verification-method.md | 成功の検証と読み戻しの方法 |
| references/acceptance-criteria.md | ツール呼び出しの正確性に関する受け入れ基準 |
| references/ram-policies.md | Yunxiao の権限モデルと標準の Alibaba Cloud RAM の比較 |