mcpField
A
aliyun-devops-manage

aliyun-devops-manage

github.com/cinience云与 DevOps39659 次安装11 周前更新
代码仓库

关于 aliyun-devops-manage

aliyun-devops-manage 是通过 OpenAPI 管理 Alibaba Cloud DevOps（云效）的技能，面向需要检查项目、仓库、流水线、工作项、测试与发布状态的运维场景，并强调先发现 API、再执行变更。

主要功能

  1. 01项目清单与成员检查
  2. 02仓库和流水线列表
  3. 03工作项与测试检查
  4. 04发布和执行状态查询
  5. 05OpenAPI 元数据发现

适用场景

  1. 01查看组织内项目和仓库
  2. 02检查流水线及发布执行状态
  3. 03检查工作项和测试用例

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/aliyun-devops-manage确认已加载。

包含的文件

除 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

详细介绍

Category: 服务

阿里云 DevOps（云效）

用途

使用阿里云 DevOps OpenAPI 支持：

  • 项目、代码仓库和流水线盘点
  • 工作项和测试资源检查
  • 发布和执行状态检查
  • 在生产变更前通过元数据发现 API

前提条件

  • 配置遵循最小权限原则的阿里云凭证。
  • 为本地脚本安装 Python SDK 依赖：
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U alibabacloud_devops20210625 alibabacloud_tea_openapi
  • 优先使用环境变量：
    • ALIBABACLOUD_ACCESS_KEY_ID
    • ALIBABACLOUD_ACCESS_KEY_SECRET
    • 可选的 ALIBABACLOUD_REGION_ID

AccessKey 优先级

  1. 环境变量：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID
  2. 共享凭证文件：~/.alibabacloud/credentials

如果区域或环境不明确，请在执行变更操作前向用户确认。

兼容性说明：运行时脚本也接受 ALIBABA_CLOUD_* 和 ALICLOUD_* 别名，但新示例和自动化中首选 ALIBABACLOUD_* 前缀。

工作流

  1. 确认目标组织／项目范围和变更窗口。
  2. 执行 API 发现，并确认确切的 API 名称和必需参数。
  3. 优先执行只读 API（List* / Get* / Query*）。
  4. 仅在确认回滚方案和负责人后执行变更 API。
  5. 将输出和证据保存到 output/aliyun-devops-manage/。

API 发现

  • 产品代码：devops
  • 默认 API 版本：2021-06-25
  • 元数据来源：https://api.aliyun.com/meta/v1/products/devops/versions/2021-06-25/api-docs.json

最简可执行快速入门

python skills/platform/devops/aliyun-devops-manage/scripts/list_openapi_meta_apis.py

可选参数：

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

列出项目（只读）：

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

列出代码仓库（只读）：

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

列出流水线（只读）：

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

常见操作映射

  • 项目和成员：CreateProject、GetProject、ListProjectMembers、UpdateProject
  • 代码仓库：CreateRepository、GetRepository、ListRepositories、CreateMergeRequest
  • 流水线和发布：CreatePipeline、GetPipeline、ListPipelines、RunPipeline
  • 工作项和测试：CreateWorkitem、GetWorkitemDetail、ListTestCase、CreateTestCase

分组 API 请参阅 references/api_quick_map.md。

脚本目录

  • scripts/list_openapi_meta_apis.py：获取元数据并生成 API 清单文件。
  • scripts/list_projects.py：列出一个组织中的项目。
  • scripts/list_repositories.py：列出一个组织中的代码仓库。
  • scripts/list_pipelines.py：列出一个组织中的流水线。

验证

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

通过标准：命令以 0 退出，且已生成 output/aliyun-devops-manage/validate.txt。

输出和证据

  • 将产物、命令输出和 API 响应摘要保存到 output/aliyun-devops-manage/。
  • 在证据文件中包含关键参数（区域／资源 ID／时间范围），以便复现。

参考资料

  • 来源列表：references/sources.md
  • API 快速映射：references/api_quick_map.md
  • 操作模板：references/templates.md

评论

支持 Markdown