← 返回 Skills 市场
Codeup
作者
Yu-Xiao-Sheng
· GitHub ↗
· v1.0.0
· MIT-0
100
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install codeup
功能描述
阿里云云效 Codeup 代码仓库管理工具集。使用场景包括:(1) 代码仓库操作 - 分支管理、文件操作、代码对比、合并请求/MR管理 (2) 组织管理 - 部门管理、成员查询、角色管理 (3) 操作 codeup 仓库、分支、MR、合并请求 (4) 查询云效组织成员、部门列表
使用说明 (SKILL.md)
Codeup Skill
本 skill 提供与云效(Codeup)平台交互的 Python 脚本工具,统一通过 codeup.py 调用。
环境配置
使用前需要配置以下环境变量:
export YUNXIAO_ACCESS_TOKEN="你的个人访问令牌"
获取访问令牌:
- 登录阿里云控制台
- 进入云效(Codeup)
- 设置 -> 访问令牌管理 -> 创建个人访问令牌
使用方式
python scripts/codeup.py \x3Ccommand> [参数]
所有命令默认输出 JSON 格式结果。
命令列表
用户与组织
| 命令 | 说明 |
|---|---|
get_current_user |
获取当前用户信息 |
list_organizations |
列出用户所属组织(获取 org_id) |
部门与成员
| 命令 | 说明 |
|---|---|
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,update_change_request_comment,list_merge_request_patch_sets
使用示例:
# 方式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 "# 新文档\
\
这是内容" \
--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
安全使用建议
This skill appears to implement a legitimate Codeup (阿里云云效) CLI that needs a YUNXIAO_ACCESS_TOKEN to call AlibabaCloud APIs. Before installing or running it: 1) Note the registry metadata incorrectly states there are no required env vars — you must set YUNXIAO_ACCESS_TOKEN in your environment. 2) Treat that token as sensitive: use a token with the minimum scope needed, and avoid exposing long-lived high-privilege tokens. 3) Inspect the scripts locally (they are provided) and run them in a controlled environment first; the CLI issues HTTP requests to https://openapi-rdc.aliyuncs.com. 4) If you plan to let an autonomous agent use this skill, be cautious — the agent will be able to use the token to list org members, read/write files, create/delete branches and MRs. 5) Consider testing with a read-only or limited-scope token, and confirm the behavior of functions that require commit messages or may raise ValueError (some tests indicate certain parameters are mandatory).
功能分析
Type: OpenClaw Skill
Name: codeup
Version: 1.0.0
The 'codeup' skill bundle is a legitimate toolset for interacting with Alibaba Cloud's Codeup (DevOps) platform. It provides a comprehensive CLI (scripts/codeup.py) and a Python client (scripts/codeup_client.py) to manage repositories, branches, files, and merge requests via the official Alibaba Cloud OpenAPI (openapi-rdc.aliyuncs.com). The code is well-structured, includes extensive unit and integration tests (scripts/test_codeup.py), and its behavior aligns perfectly with the stated purpose in SKILL.md without any signs of data exfiltration, obfuscation, or malicious intent.
能力评估
Purpose & Capability
Name and description claim a Codeup (阿里云云效) repository/org management tool; included Python client and CLI scripts implement exactly those operations against an AlibabaCloud API endpoint. The functionality requested (token-based API access) is appropriate for the stated purpose. However the registry metadata lists 'Required env vars: none' while both SKILL.md and the code require YUNXIAO_ACCESS_TOKEN — a mismatch between metadata and actual requirements.
Instruction Scope
SKILL.md instructs the user to set YUNXIAO_ACCESS_TOKEN and to run the provided Python CLI; the code implements the documented commands. The instructions do not request other system files, unrelated credentials, or exfiltration endpoints; network calls are limited to a single BASE_URL (openapi-rdc.aliyuncs.com) consistent with AlibabaCloud APIs.
Install Mechanism
There is no install spec (instruction-only skill plus included scripts). The package includes a simple requirements.txt (requests) and Python scripts; no remote downloads, installers, or archive extraction are used. Risk from install mechanism is low, but the runtime requires Python and the 'requests' library.
Credentials
Runtime code and SKILL.md require a single API token (YUNXIAO_ACCESS_TOKEN), which is proportionate for a remote API client. The concern is the metadata omission: the skill registry claims no required environment variables while the skill actually requires a sensitive token. This mismatch could mislead users into installing without preparing the token or misunderstanding what will be accessed. Also review token scope and rotate/remove tokens used for testing.
Persistence & Privilege
Skill flags show always: false and model invocation is not disabled (normal). The skill does not request persistent system-wide changes or modify other skills. It simply runs as an on-demand CLI that performs network calls.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install codeup - 安装完成后,直接呼叫该 Skill 的名称或使用
/codeup触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of Codeup skill.
- Provides a command-line toolset for managing 阿里云云效 (Codeup) repositories, branches, files, merge requests, organizations, departments, and members via `codeup.py`.
- Supports repository identification by both numeric ID and URL-encoded path, streamlining operations.
- Includes commands for all major Codeup features: repository info, branch operations, file management, code comparison, merge request management, and organization/member queries.
- Outputs results in JSON format for all commands.
- Detailed usage instructions and examples provided in SKILL.md.
元数据
常见问题
Codeup 是什么?
阿里云云效 Codeup 代码仓库管理工具集。使用场景包括:(1) 代码仓库操作 - 分支管理、文件操作、代码对比、合并请求/MR管理 (2) 组织管理 - 部门管理、成员查询、角色管理 (3) 操作 codeup 仓库、分支、MR、合并请求 (4) 查询云效组织成员、部门列表. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 100 次。
如何安装 Codeup?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install codeup」即可一键安装,无需额外配置。
Codeup 是免费的吗?
是的,Codeup 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Codeup 支持哪些平台?
Codeup 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Codeup?
由 Yu-Xiao-Sheng(@yu-xiao-sheng)开发并维护,当前版本 v1.0.0。
推荐 Skills