| name | gitcode-review |
| description | GitCode 平台的 Pull Request 代码审查专家。当用户需要审查 GitCode 上的 PR 时使用，包括：(1) 查看 PR 列表，(2) 分析代码变更，(3) 提供中文代码审查报告，(4) 可选地将审查结果提交到 PR 评论区。支持通过 /review 命令或直接提示词触发。 |
GitCode PR 代码审查 Skill
本 Skill 提供 GitCode 平台的专业代码审查能力，输出中文审查报告。
快速开始
在 Claude Code 中使用
用户可以通过以下方式触发审查：
/review
/review <PR编号>
在其他环境中使用
用户可以直接说：
- "审查这个 PR"
- "帮我 review 一下 PR #2"
- "查看最近的 Pull Request"
审查流程
按以下步骤执行代码审查：
1. 获取 PR 信息
如果用户未指定 PR 编号：
使用 GitCode MCP 工具列出所有 PR：
使用 mcp__gitcode__list_pull_requests 工具
参数：owner（仓库所有者）、repo（仓库名称）
从 PR 列表中选择最近的或让用户选择要审查的 PR。
如果用户指定了 PR 编号：
直接获取该 PR 的详细信息：
使用 mcp__gitcode__get_pull_request 工具
参数：owner、repo、pull_number
2. 获取代码变更
使用 GitCode API 的 compare 端点获取 PR 的 diff：
curl -s "https://gitcode.com/api/v5/repos/{owner}/{repo}/compare/{base_sha}...{head_sha}?access_token={token}"
从 PR 信息中提取：
base.sha - 基础分支的 commit SHAhead.sha - PR 分支的 commit SHA
API 返回的 files 数组包含每个文件的：
filename - 文件路径status - 修改状态（modified/added/deleted）additions - 新增行数deletions - 删除行数patch - diff 格式的代码变更
3. 分析代码变更
对每个修改的文件进行分析，关注：
代码质量：
代码正确性：
性能影响：
安全考虑：
可维护性：
4. 生成中文审查报告
按以下格式输出审查报告：
## 代码审查：PR #{编号} - {标题}
### 概述
[简要说明 PR 的目的和主要变更]
### 变更详情
- **文件**: {文件路径}
- **位置**: 第 X-Y 行
- **变更**: +{新增行数} 行，-{删除行数} 行
### 代码质量分析
**优点：**
- ✅ [列出做得好的地方]
**需要改进的地方：**
1. **{问题类别}**
```{语言}
// 当前写法
{当前代码}
// 建议改为
{改进后的代码}
潜在问题和风险
- {问题标题}
建议的改进版本
{完整的改进代码示例}
总体评价
评分: X/10
总结:
建议操作:
- [具体的改进建议]
- [测试建议]
- [其他建议]
### 5. 询问是否提交评论
审查报告生成后，询问用户：
是否需要将此审查报告提交到 PR #{编号} 的评论区？
如果需要，我将使用 mcp__gitcode__create_pull_request_comment 工具提交评论。
如果用户同意，使用以下工具提交：
使用 mcp__gitcode__create_pull_request_comment 工具
参数：
- owner: 仓库所有者
- repo: 仓库名称
- pull_number: PR 编号
- body: 审查报告的 Markdown 内容
## 审查最佳实践
参考 `references/review-guidelines.md` 了解详细的代码审查指南。
## 注意事项
1. **保持客观和建设性**：提供具体的改进建议，而不是简单的批评
2. **关注重要问题**：优先指出安全、性能和正确性问题
3. **提供示例**：用代码示例说明建议的改进
4. **考虑上下文**：理解 PR 的目的和项目的整体架构
5. **尊重作者**：认可做得好的地方，鼓励持续改进
## 环境要求
- 需要配置 GitCode MCP 服务器
- 需要有效的 GITCODE_TOKEN 环境变量
- 需要对目标仓库有读取权限
## 故障排除
**问题：无法获取 PR 信息**
- 检查 GITCODE_TOKEN 是否有效
- 确认对仓库有访问权限
- 验证 owner 和 repo 参数是否正确
**问题：diff 信息为空**
- 检查 PR 是否已经合并
- 确认 base 和 head SHA 是否正确
- 尝试使用 PR 的 diff_refs 中的 SHA
**问题：无法提交评论**
- 确认对仓库有写入权限
- 检查 PR 是否仍然打开
- 验证评论内容格式是否正确
