Codeup Python工具：云效平台API命令行脚本，支持仓库、分支、文件、合并请求管理 | SkillsMD⚠️重要前提
安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →
Codeup Python工具：云效平台API命令行脚本，支持仓库、分支、文件、合并请求管理
codeup by abcfed/claude-marketplace
npx skills add https://github.com/abcfed/claude-marketplace --skill codeup🇨🇳中文介绍
Codeup Skill
本 skill 提供与云效（Codeup）平台交互的 Python 脚本工具，统一通过 codeup.py 调用。
环境配置
使用前需要配置以下环境变量：
export YUNXIAO_ACCESS_TOKEN="你的个人访问令牌"
获取访问令牌：
- 登录阿里云控制台
- 进入云效（Codeup）
- 设置 -> 访问令牌管理 -> 创建个人访问令牌
使用方式
python scripts/codeup.py <command> [参数]
所有命令默认输出 JSON 格式结果。
命令列表
用户与组织
| 命令 | 说明 |
|---|
get_current_user | 获取当前用户信息 |
list_organizations |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
部门与成员
| 命令 | 说明 |
|---|
list_departments | 列出部门 |
get_department | 获取部门详情 |
list_members | 列出组织成员 |
get_organization_member | 获取成员详情 |
search_members | 搜索成员 |
list_roles | 列出角色 |
仓库操作
| 命令 | 说明 |
|---|
get_repository | 获取仓库详情 |
list_repositories | 列出仓库 |
repo_id 参数格式（通用）
所有支持repo_id 参数的命令都支持两种格式：
| 格式 | 示例 | 说明 |
|---|
| 数字 ID | 5822285 | 仓库的数字 ID |
| URL-Encoder 路径 | abcyun%2Fabc-fed-common%2Fabc-nestjs-lib | 编码后的 namespace/group/repoName |
- 仓库操作:
get_repository
- 分支操作:
get_branch, create_branch, delete_branch, list_branches
- 文件操作:
get_file, create_file, update_file, delete_file, list_files
- 代码对比:
compare
- MR 操作:
get_change_request, create_merge_request, close_merge_request, merge_change_request, reopen_change_request, review_change_request, update_change_request, get_change_request_tree, create_merge_request_comment, list_merge_request_comments, delete_change_request_comment, ,
# 方式1: 使用数字 ID
python scripts/codeup.py get_repository --org_id 62d62893487c500c27f72e36 --repo_id 5822285
# 方式2: 使用 URL-Encoder 编码路径
python scripts/codeup.py get_repository \
--org_id 62d62893487c500c27f72e36 \
--repo_id abcyun%2Fabc-fed-common%2Fabc-nestjs-lib
# 分支操作也支持
python scripts/codeup.py list_branches \
--org_id 62d62893487c500c27f72e36 \
--repo_id abcyun%2Fabc-fed-common%2Fabc-nestjs-lib
# 文件操作也支持
python scripts/codeup.py get_file \
--org_id 62d62893487c500c27f72e36 \
--repo_id abcyun%2Fabc-fed-common%2Fabc-nestjs-lib \
--file_path README.md \
--branch master
使用场景 : 当用户提供仓库 URL 时（如 https://codeup.aliyun.com/abcyun/abc-fed-common/abc-nestjs-lib/change/1），LLM 可以：
- 提取路径:
abcyun/abc-fed-common/abc-nestjs-lib
- URL 编码
/ 为 %2F: abcyun%2Fabc-fed-common%2Fabc-nestjs-lib
- 直接调用任何命令，无需先查询 repo_id
分支操作
| 命令 | 说明 |
|---|
get_branch | 获取分支详情 |
create_branch | 创建分支 |
delete_branch | 删除分支 |
list_branches | 列出分支 |
文件操作
| 命令 | 说明 |
|---|
get_file | 获取文件内容 |
create_file | 创建文件 |
update_file | 更新文件 |
delete_file | 删除文件 |
list_files | 列出文件树 |
compare | 对比代码差异 |
合并请求
| 命令 | 说明 |
|---|
get_change_request | 获取 MR 详情 |
list_merge_requests | 列出 MR |
create_merge_request | 创建 MR |
close_merge_request | 关闭 MR |
merge_change_request | 合并 MR |
reopen_change_request | 重新打开已关闭的 MR |
review_change_request | 审查 MR（批准/拒绝） |
update_change_request | 更新 MR 信息 |
get_change_request_tree | 获取 MR 变更文件列表 |
create_merge_request_comment | 添加 MR 评论 |
list_merge_request_comments | 列出 MR 评论 |
delete_change_request_comment | 删除 MR 评论 |
update_change_request_comment | 更新 MR 评论 |
list_merge_request_patch_sets | 列出 MR 补丁集 |
使用示例
查询组织信息
# 获取当前用户
python scripts/codeup.py get_current_user
# 列出用户所属组织（获取 org_id）
python scripts/codeup.py list_organizations
组织成员管理
# 列出部门
python scripts/codeup.py list_departments --org_id 62d62893487c500c27f72e36
# 获取部门详情
python scripts/codeup.py get_department --org_id 62d62893487c500c27f72e36 --dept_id 68d910db15dfc6c8604fccb4
# 列出所有成员
python scripts/codeup.py list_members --org_id 62d62893487c500c27f72e36
# 获取成员详情
python scripts/codeup.py get_organization_member --org_id 62d62893487c500c27f72e36 --member_id 639fe0e38d9a873a30aad3df
# 搜索成员
python scripts/codeup.py search_members --org_id 62d62893487c500c27f72e36 --query "姓名"
# 列出角色
python scripts/codeup.py list_roles --org_id 62d62893487c500c27f72e36
仓库与分支管理
# 列出仓库
python scripts/codeup.py list_repositories --org_id 62d62893487c500c27f72e36
# 获取仓库详情
python scripts/codeup.py get_repository --org_id 62d62893487c500c27f72e36 --repo_id 5822285
# 列出分支
python scripts/codeup.py list_branches --org_id 62d62893487c500c27f72e36 --repo_id 5822285
# 创建分支
python scripts/codeup.py create_branch \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--branch_name feature/new-feature \
--source_branch master
# 删除分支
python scripts/codeup.py delete_branch \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--branch_name feature/old-feature
文件操作
# 获取文件内容
python scripts/codeup.py get_file \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--file_path README.md \
--branch master
# 创建文件
python scripts/codeup.py create_file \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--file_path docs/new-doc.md \
--content "# 新文档\n\n这是内容" \
--branch feature/new-feature \
--message "Add new documentation"
# 更新文件
python scripts/codeup.py update_file \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--file_path README.md \
--content "# 更新后的内容" \
--message "Update README"
# 列出文件
python scripts/codeup.py list_files \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--path src \
--branch master
# 对比代码
python scripts/codeup.py compare \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--from feature/new-feature \
--to master
合并请求管理
# 列出 MR
python scripts/codeup.py list_merge_requests \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285
# 列出打开的 MR
python scripts/codeup.py list_merge_requests \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--state opened
# 获取 MR 详情
python scripts/codeup.py get_change_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584
# 创建 MR
python scripts/codeup.py create_merge_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--title "Feature: 新功能" \
--source_branch feature/new-feature \
--target_branch master \
--description "实现用户登录功能"
# 关闭 MR
python scripts/codeup.py close_merge_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584
# 添加 MR 评论
python scripts/codeup.py create_merge_request_comment \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--content "代码审查通过"
# 列出 MR 评论
python scripts/codeup.py list_merge_request_comments \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584
# 列出 MR 补丁集（提交）
python scripts/codeup.py list_merge_request_patch_sets \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584
# 合并 MR
python scripts/codeup.py merge_change_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--merge_type "no-fast-forward" \
--remove_source_branch
# 重新打开已关闭的 MR
python scripts/codeup.py reopen_change_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584
# 审查 MR（批准）
python scripts/codeup.py review_change_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--review_opinion PASS \
--review_comment "代码审查通过"
# 审查 MR（拒绝）
python scripts/codeup.py review_change_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--review_opinion NOT_PASS \
--review_comment "需要修复单元测试"
# 更新 MR 标题
python scripts/codeup.py update_change_request \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--title "新的 MR 标题"
# 获取 MR 变更文件列表
python scripts/codeup.py get_change_request_tree \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--from_patch_set_id patch_set_1 \
--to_patch_set_id patch_set_2
# 删除 MR 评论
python scripts/codeup.py delete_change_request_comment \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--comment_biz_id 682d5c6d8a3b400a8c4b1234
# 更新 MR 评论
python scripts/codeup.py update_change_request_comment \
--org_id 62d62893487c500c27f72e36 \
--repo_id 5822285 \
--local_id 584 \
--comment_biz_id 682d5c6d8a3b400a8c4b1234 \
--content "更新后的评论内容"
常用命令速查
# 组织成员
python scripts/codeup.py list_members --org_id 62d62893487c500c27f72e36
python scripts/codeup.py search_members --org_id 62d62893487c500c27f72e36 --query "姓名"
# 仓库操作
python scripts/codeup.py list_repositories --org_id 62d62893487c500c27f72e36
python scripts/codeup.py list_branches --org_id 62d62893487c500c27f72e36 --repo_id 5822285
# 文件操作
python scripts/codeup.py get_file --org_id 62d62893487c500c27f72e36 --repo_id 5822285 --file_path README.md
# MR 操作
python scripts/codeup.py list_merge_requests --org_id 62d62893487c500c27f72e36 --repo_id 5822285 --state opened
python scripts/codeup.py get_change_request --org_id 62d62893487c500c27f72e36 --repo_id 5822285 --local_id 584
Claude 使用方式
- 获取 org_id ：先调用
list_organizations 获取组织列表，选择目标组织
- 获取 repo_id ：
- 方式一：调用
list_repositories 列出仓库，选择目标仓库获取数字 ID
- 方式二：从用户提供的 URL 或路径中提取
namespace/group(可选)/repoName，然后使用，
- 构建命令 ：根据需求构建相应参数
- 执行脚本 ：使用 Bash 工具运行
- 处理结果 ：解析输出，分析数据
用户: "查看当前组织的成员列表"
Claude:
1. python scripts/codeup.py list_organizations # 获取 org_id
2. python scripts/codeup.py list_members --org_id $ORG_ID # 列出成员
3. 分析返回结果并展示
常见问题
1. 如何获取 org_id 和 repo_id？
# 列出用户所属组织（包含 org_id）
python scripts/codeup.py list_organizations
# 列出仓库（包含 repo_id）
python scripts/codeup.py list_repositories --org_id 62d62893487c500c27f72e36
2. 权限不足怎么办？
- 仓库读取权限：查看仓库、分支、文件
- 仓库写入权限：创建/更新/删除文件、创建分支
- MR 管理权限：创建/更新 MR、添加评论
3. 合并请求状态值
| 状态 | 说明 |
|---|
opened | 打开中 |
closed | 已关闭 |
merged | 已合并 |
文件结构
codeup/
├── SKILL.md
├── references/
│ ├── code-management.md # 代码管理 API 参考
│ └── organization-management.md # 组织管理 API 参考
└── scripts/
├── codeup.py # 统一入口脚本（34个子命令）
├── codeup_client.py # Codeup API 客户端
└── requirements.txt # 依赖：requests>=2.28.0
Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU
127,000 周安装
update_change_request_comment
list_merge_request_patch_sets
