codeup
阿里云云效 Codeupのコードリポジトリ管理ツールとして、組織管理やメンバー管理、コードの比較やマージリクエストなど、開発に必要な一連の操作を効率的に行うことを支援するSkill。
📜 元の英語説明(参考)
阿里云云效 Codeup 代码仓库管理工具集。使用场景包括:(1) 代码仓库操作 - 分支管理、文件操作、代码对比、合并请求/MR管理 (2) 组织管理 - 部门管理、成员查询、角色管理 (3) 操作 codeup 仓库、分支、MR、合并请求 (4) 查询云效组织成员、部门列表
🇯🇵 日本人クリエイター向け解説
阿里云云效 Codeupのコードリポジトリ管理ツールとして、組織管理やメンバー管理、コードの比較やマージリクエストなど、開発に必要な一連の操作を効率的に行うことを支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o codeup.zip https://jpskill.com/download/8795.zip && unzip -o codeup.zip && rm codeup.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8795.zip -OutFile "$d\codeup.zip"; Expand-Archive "$d\codeup.zip" -DestinationPath $d -Force; ri "$d\codeup.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
codeup.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
codeupフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Codeup Skill
本 skill は、云效(Codeup)プラットフォームとやり取りするための Python スクリプトツールを提供します。統一的に codeup.py を通じて呼び出されます。
環境設定
使用前に、以下の環境変数を設定する必要があります。
export YUNXIAO_ACCESS_TOKEN="あなたの個人アクセス令牌"
アクセス令牌の取得方法:
- 阿里云控制台にログインします。
- 云效(Codeup)に入ります。
- 設定 -> 訪問令牌管理 -> 個人訪問令牌の作成
使用方式
python scripts/codeup.py <command> [パラメータ]
すべてのコマンドは、デフォルトで 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 パラメータをサポートするすべてのコマンドは、次の2つの形式をサポートします:
| 形式 | 例 | 説明 |
|---|---|---|
| 数字 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 /を%2Fに URL エンコード:abcyun%2Fabc-fed-common%2Fabc-nestjs-librepo_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 62d
(原文がここで切り詰められています) 📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Codeup Skill
本 skill 提供与云效(Codeup)平台交互的 Python 脚本工具,统一通过 codeup.py 调用。
环境配置
使用前需要配置以下环境变量:
export YUNXIAO_ACCESS_TOKEN="你的个人访问令牌"
获取访问令牌:
- 登录阿里云控制台
- 进入云效(Codeup)
- 设置 -> 访问令牌管理 -> 创建个人访问令牌
使用方式
python scripts/codeup.py <command> [参数]
所有命令默认输出 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 "# 新文档\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