菜单
GitCode 平台 Pull Request 自动化代码审查技能。当用户提供 GitCode PR URL 或提到"审查 GitCode PR"、"GitCode 代码评审"时触发。支持自动获取 PR 信息、执行安全/质量审查、发布行级评论到 GitCode。必须提供 GitCode Token。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | gitcode-pr-review |
| description | GitCode 平台 Pull Request 自动化代码审查技能。当用户提供 GitCode PR URL 或提到"审查 GitCode PR"、"GitCode 代码评审"时触发。支持自动获取 PR 信息、执行安全/质量审查、发布行级评论到 GitCode。必须提供 GitCode Token。 |
对 GitCode 平台的 Pull Request 进行自动化代码审查，识别潜在问题、安全漏洞并提供改进建议。
| 参数 | 说明 | 必填 | 示例 |
|---|---|---|---|
| 仓库 Clone 地址 | GitCode 仓库克隆地址 | 是* | https://gitcode.com/user/repo.git |
| PR 编号 | Pull Request 编号 | 是 | 123 |
| GitCode Token | 个人访问令牌 | 是 | your-token |
| 本地仓库路径 | 已有的仓库目录 | 否* | /home/user/myproject |
*注：如提供本地仓库路径，Clone 地址可从本地获取。
执行中需记录以下变量：
| 变量名 | 说明 | 示例 |
|---|---|---|
REPO_DIR | 仓库绝对路径 | /home/user/pr_review/myproject |
HAS_LOCAL_REPO | 是否使用已有仓库 | true / false |
ORIGINAL_BRANCH | 原始分支名 | main |
HAS_STASH | 是否执行了 stash | true / false |
重要：
REPO_DIR最关键，后续 git 命令都必须使用git -C "$REPO_DIR"语法。
缓存文件：~/.gitcode-pr-review/repo_cache.json
格式：{"repos": {"<仓库URL>": "<本地路径>"}}
用途：下次审查相同仓库时自动使用缓存路径，无需重复询问。
首先检查缓存：
缓存未命中时询问：用户是否有仓库目录？
情况 A：用户已有仓库
pwd → REPO_DIRgit -C "$REPO_DIR" branch --show-current情况 B：用户没有仓库
执行步骤 1 克隆仓库，然后继续步骤 2。
mkdir -p pr_review && cd pr_review && git clone <仓库地址> && pwd
立即记录：REPO_DIR = <pwd输出>/<项目名>
git -C "$REPO_DIR" fetch <仓库地址> merge-requests/<PR编号>/head:review-<PR编号>
git -C "$REPO_DIR" checkout review-<PR编号>
常见错误：
git diff origin/dev review-<PR>会显示所有累积差异，而非 PR 实际变更。
正确方法（三选一）：
# 方法 1：通过 API（推荐）
python3 <技能目录>/scripts/get_pr_info.py <Token> <owner> <repo> <PR编号> --files
# 方法 2：merge-base
git -C "$REPO_DIR" diff $(git -C "$REPO_DIR" merge-base origin/dev review-<PR编号>) review-<PR编号> --stat
# 方法 3：查看 commits
git -C "$REPO_DIR" log origin/dev..review-<PR编号> --oneline
python3 <技能目录>/scripts/get_pr_info.py <Token> <owner> <repo> <PR编号>
输出包含：PR 基本信息、声称的修改点、文件变更、commits 信息。
关键用途：理解 PR 目的，验证修改是否全面覆盖声称的问题。
重要：基于完整文件内容审查，而非仅看 diff。
审查步骤：
references/checklists.md）详细审查清单请参阅：checklists.md
先展示完整报告，然后询问是否发布到 GitCode PR。
用户确认后执行：
export GITCODE_TOKEN="<Token>"
export REPO_OWNER="<owner>"
export REPO_NAME="<repo>"
export PR_NUMBER="<PR编号>"
python3 <技能目录>/scripts/pr-comment.py -f <技能目录>/pr_review_report.md --parse-report
行级评论格式规范请参阅：comment-format.md
情况 B（新克隆仓库）：询问是否删除临时目录
情况 A（用户已有仓库）：
git -C "$REPO_DIR" checkout <ORIGINAL_BRANCH>git -C "$REPO_DIR" stash pop报告必须包含以下章节：
详细格式规范：report-template.md
行级评论格式：comment-format.md
git -C "$REPO_DIR"#L10 或 #L10-15（脚本自动取首行号）| 文件 | 用途 |
|---|---|
| checklists.md | 完整审查清单 |
| comment-format.md | 行级评论格式规范 |
| report-template.md | 报告格式模板 |
| examples.md | 完整执行示例 |
GitCode 平台发行版（Release）自动创建技能。当用户提到"创建发行版"、"发布 Release"、"打 Tag 发布"、"创建 GitCode Release"、"新建发行版"、"发版"时触发。自动分析本地 Git 仓库信息，推断版本号，生成发行版描述，创建 Tag 和 Release。必须提供 GitCode Token。
GitCode Pull Request 评论处理技能。当用户提到"处理PR评论"、"修复评论问题"、"回复评论"、"验证评论有效性"、"查看评论内容"、或提供PR URL询问评论问题时触发。自动获取评论、分析有效性、辅助修复并线程式回复。支持仓库缓存、工作区保护、批量修复。
GitCode API 帮助技能。当用户提到 GitCode API、需要查询 GitCode API 用法、参数说明、端点信息，或需要调用 GitCode 平台接口时，自动触发此技能。支持按关键词、API 端点、功能分类检索相关 API 文档，并提供详细的参数说明和代码示例。此技能也可被其他技能调用，用于获取 GitCode API 信息。