mcpField
A
alicloud-platform-devops

alicloud-platform-devops

github.com/cinienceCloud & DevOps396132 installsUpdated 11w ago
Repository

About alicloud-platform-devops

A skill for working with Alibaba Cloud DevOps OpenAPI, aimed at teams inspecting development resources and release status. It supports API metadata discovery before read-only checks or confirmed changes, and saves operation evidence.

Key features

  1. 01Discover and list OpenAPI metadata
  2. 02Inventory projects, repositories, and pipelines
  3. 03Inspect work items and test resources
  4. 04Check release and execution status
  5. 05Save operation parameters and response evidence

Use cases

  1. 01Inventory an organization’s projects and repositories
  2. 02Check pipeline and release execution status
  3. 03Use API metadata to confirm APIs and parameters
  4. 04Make changes after confirming a rollback plan

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-platform-devops

After installing, type/alicloud-platform-devopsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
api_quick_map.md
sources.md
templates.md
scripts/
_devops_client.py
list_openapi_meta_apis.py
list_pipelines.py
list_projects.py
list_repositories.py

Details

From the project README

Category: service

Alibaba Cloud DevOps (Yunxiao)

Purpose

Use Alibaba Cloud DevOps OpenAPI to support:

  • project, repository, and pipeline inventory
  • work item and test resource inspection
  • release and execution status checks
  • metadata-driven API discovery before production changes

Prerequisites

  • Configure least-privilege Alibaba Cloud credentials.
  • Install Python SDK dependencies for local scripts:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U alibabacloud_devops20210625 alibabacloud_tea_openapi
  • Prefer environment variables:
    • ALICLOUD_ACCESS_KEY_ID
    • ALICLOUD_ACCESS_KEY_SECRET
    • optional ALICLOUD_REGION_ID

AccessKey Priority

  1. Environment variables: ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID
  2. Shared credentials file: ~/.alibabacloud/credentials

If region/environment is unclear, confirm with user before mutating operations.

Workflow

  1. Confirm target organization/project scope and change window.
  2. Run API discovery and confirm exact API names and required parameters.
  3. Execute read-only APIs first (List* / Get* / Query*).
  4. Run mutating APIs only after rollback and owner confirmation.
  5. Save outputs and evidence to output/alicloud-platform-devops/.

API Discovery

  • Product code: devops
  • Default API version: 2021-06-25
  • Metadata source: https://api.aliyun.com/meta/v1/products/devops/versions/2021-06-25/api-docs.json

Minimal Executable Quickstart

python skills/platform/devops/alicloud-platform-devops/scripts/list_openapi_meta_apis.py

Optional arguments:

python skills/platform/devops/alicloud-platform-devops/scripts/list_openapi_meta_apis.py \
  --product-code devops \
  --version 2021-06-25 \
  --output-dir output/alicloud-platform-devops

List projects (read-only):

python skills/platform/devops/alicloud-platform-devops/scripts/list_projects.py \
  --organization-id <organization-id> \
  --region cn-hangzhou \
  --max-results 20 \
  --output output/alicloud-platform-devops/projects.txt

List repositories (read-only):

python skills/platform/devops/alicloud-platform-devops/scripts/list_repositories.py \
  --organization-id <organization-id> \
  --region cn-hangzhou \
  --page 1 \
  --per-page 20 \
  --output output/alicloud-platform-devops/repositories.txt

List pipelines (read-only):

python skills/platform/devops/alicloud-platform-devops/scripts/list_pipelines.py \
  --organization-id <organization-id> \
  --region cn-hangzhou \
  --max-results 20 \
  --output output/alicloud-platform-devops/pipelines.txt

Common Operation Map

  • Project and membership: CreateProject, GetProject, ListProjectMembers, UpdateProject
  • Code repository: CreateRepository, GetRepository, ListRepositories, CreateMergeRequest
  • Pipeline and release: CreatePipeline, GetPipeline, ListPipelines, RunPipeline
  • Work items and test: CreateWorkitem, GetWorkitemDetail, ListTestCase, CreateTestCase

See references/api_quick_map.md for grouped APIs.

Script Catalog

  • scripts/list_openapi_meta_apis.py: fetch metadata and generate API inventory files.
  • scripts/list_projects.py: list projects in one organization.
  • scripts/list_repositories.py: list repositories in one organization.
  • scripts/list_pipelines.py: list pipelines in one organization.

Validation

mkdir -p output/alicloud-platform-devops
for f in skills/platform/devops/alicloud-platform-devops/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-platform-devops/validate.txt

Pass criteria: command exits 0 and output/alicloud-platform-devops/validate.txt is generated.

Output And Evidence

  • Save artifacts, command outputs, and API response summaries under output/alicloud-platform-devops/.
  • Include key parameters (region/resource id/time range) in evidence files for reproducibility.

References

  • Source list: references/sources.md
  • API quick map: references/api_quick_map.md
  • Operation templates: references/templates.md

Comments

Markdown supported