Skill: yu-xiao-sheng/codeup (version 1.0.0)

--- name: codeup description: 阿里云云效 Codeup 代码仓库管理工具集。使用场景包括：(1) 代码仓库操作 - 分支管理、文件操作、代码对比、合并请求/MR管理 (2) 组织管理 - 部门管理、成员查询、角色管理 (3) 操作 codeup 仓库、分支、MR、合并请求 (4) 查询云效组织成员、部门列表 --- # Codeup Skill 本 skill 提供与云效（Codeup）平台交互的 Python 脚本工具，统一通过 `codeup.py` 调用。 ## 环境配置 使用前需要配置以下环境变量： ```bash export YUNXIAO_ACCESS_TOKEN="你的个人访问令牌" ``` 获取访问令牌： 1. 登录阿里云控制台 2. 进入云效（Codeup） 3. 设置 -> 访问令牌管理 -> 创建个人访问令牌 ## 使用方式 ```bash 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` **使用示例**： ```bash # 方式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 可以： 1. 提取路径: [REDACTED_SECRET] 2. URL 编码 `/` 为 `%2F`: `abcyun%2Fabc-fed-common%2Fabc-nestjs-lib` 3. 直接调用任何命令，无需先查询 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 补丁集 | ## 使用示例 ### 查询组织信息 ```bash # 获取当前用户 python scripts/codeup.py get_current_user # 列出用户所属组织（获取 org_id） python scripts/codeup.py list_organizations ``` ### 组织成员管理 ```bash # 列出部门 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 ``` ### 仓库与分支管理 ```bash # 列出仓库 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 ``` ### 文件操作 ```bash # 获取文件内容 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 ``` ### 合并请求管理 ```bash # 列出 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 "更新后的评论内容" ``` ## 常用命令速查 ```bash # 组织成员 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 使用方式 当用户需要与云效交互时： 1. **获取 org_id**：先调用 `list_organizations` 获取组织列表，选择目标组织 2. **获取 repo_id**： - 方式一：调用 `list_repositories` 列出仓库，选择目标仓库获取数字 ID - 方式二：从用户提供的 URL 或路径中提取 `namespace/group(可选)/repoName`，然后使用， 3. **构建命令**：根据需求构建相应参数 4. **执行脚本**：使用 Bash 工具运行 5. **处理结果**：解析输出，分析数据 示例工作流： ``` 用户: "查看当前组织的成员列表" 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？ ```bash # 列出用户所属组织（包含 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 ```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)