Was macht 云效 CLI?
阿里云云效 DevOps 命令行工具。记录了云效 API 的非显而易见的陷阱和必填字段规则，帮助一次调用成功。
Voraussetzungen
| Werkzeug | Typ | Erforderlich | Installation |
|---|---|---|---|
| yunxiao MCP | mcp | Nein | In den Claude Code MCP-Einstellungen konfigurieren (bevorzugt gegenüber CLI) |
| aliyun CLI | cli | Nein | brew install aliyun-cli dann aliyun configure — siehe openapi.md für die vollständige Einrichtung |
| git | cli | Ja | brew install git oder git-scm.com |
| jq | cli | Nein | brew install jq (für JSON-Parsing im CLI-Modus) |
Mindestens eines der Werkzeuge yunxiao MCP oder aliyun CLI ist erforderlich. MCP wird bevorzugt.
Überprüfen Sie diese Werkzeuge NICHT proaktiv beim Laden der Fähigkeit. Wenn ein Befehl aufgrund eines fehlenden Werkzeugs fehlschlägt, führen Sie den Benutzer direkt Schritt für Schritt durch die Installation und Konfiguration.
Wann verwenden
- MR erstellen/verwalten: Merge Requests in codeup.aliyun.com-Repositories erstellen, Beschreibungen aktualisieren, Listen anzeigen
- Aufgabenverwaltung: Aufgabenstatus abfragen/erstellen/aktualisieren, Kommentare hinzufügen
- Release-Verwaltung: Tags über die Yunxiao-API erstellen
Werkzeugauswahl
| Bedingung | Empfohlene Methode |
|---|---|
MCP-Dienst verbunden (mcp__yunxiao__*-Werkzeuge verfügbar) | MCP-Werkzeuge bevorzugen (einschließlich MR-Operationen) |
| Kein MCP-Dienst | aliyun CLI verwenden |
| MCP-Werkzeug deckt Operation nicht ab (MR aktualisieren, Kommentare bearbeiten usw.) | aliyun CLI verwenden |
⚠️
aliyun devops ListRepositorieshat bekanntermaßen das ProblemSYSTEM_UNAUTHORIZED_ERROR. Repository-ID vorzugsweise mit MCP-Werkzeugen abrufen.
Häufige Operationen zugeordnet
| Aufgabe | MCP-Werkzeug | CLI-Alternative |
|---|---|---|
| Repository abfragen | mcp__yunxiao__list_repositories | aliyun devops ListRepositories (kann Berechtigungsfehler verursachen) |
| MR erstellen | mcp__yunxiao__create_change_request | aliyun devops CreateMergeRequest |
| MR anzeigen | mcp__yunxiao__get_change_request | aliyun devops GetMergeRequest |
| MR aktualisieren | — | aliyun devops UpdateMergeRequest |
| Aufgabe abfragen | mcp__yunxiao__search_workitems | aliyun devops ListWorkitems |
| Aufgabendetails abrufen | mcp__yunxiao__get_work_item | — |
| Aufgabenstatus aktualisieren | mcp__yunxiao__update_work_item | REST-API (siehe openapi.md) |
| Workflow abfragen | mcp__yunxiao__get_work_item_workflow | aliyun devops ListWorkItemWorkFlowStatus |
| Kommentar hinzufügen | mcp__yunxiao__create_work_item_comment | REST-API (siehe openapi.md) |
| Kommentar bearbeiten | — | aliyun devops UpdateWorkitemComment |
| Feldkonfiguration abfragen | mcp__yunxiao__get_work_item_type_field_config | aliyun devops ListWorkItemAllFields |
| Tag erstellen | — | aliyun devops CreateTag |
Top 5 Fallstricke
Die häufigsten Fehler, vollständige Regeln in cheatsheet.md:
- Repository-ID-Feld ist
Id(großes I) —jqmit.idgibtnullzurück - Bei der Erstellung eines MR müssen
sourceProjectId,targetProjectId,createFrom: "WEB"angegeben werden - Aufgabenstatus muss über REST-API aktualisiert werden —
aliyun devops POST /organization/.../workitems/updateWorkitemField updateWorkitemPropertyRequestmuss ein Array sein[{...}], Feldnamen mitfieldIdentifier/fieldValue- Vor der Aufgabenerstellung müssen Pflichtfelder abgefragt werden — verschiedene Projekte haben unterschiedliche benutzerdefinierte Pflichtfelder
Detaillierte Anleitung
- Unverzichtbar für KI-Assistenten: cheatsheet.md — 13 goldene Regeln + vollständige Fehlersuchtabelle
- Vollständige API-Referenz: openapi.md — Konfigurationsanleitung, alle API-Operationsvorlagen, vollständiger MR-/Aufgaben-/Release-Workflow