必须先确认代码平台类型再配置提示词:GitHub用{{pull_request.title}}等变量并要求输出“文件路径+行号+建议”;GitLab需区分官方/自建实例,注意changes结构和路径前缀;Bitbucket须启用兼容模式、改用{{pullrequest.patch}}、禁用行号约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为飞书智能伙伴配置代码评审提示词,但不同开发平台(如 github、gitlab、bitbucket)的 pr/mr 页面结构、事件字段、api 响应格式差异很大,直接复用同一套提示词会导致模型无法准确定位文件变更、遗漏评论位置或误解提交上下文。先确认平台类型与事件触发源
打开飞书智能伙伴的「工作流设置」→「代码评审触发器」,查看当前绑定的代码平台图标和 Webhook 来源域名:GitHub 显示 github.com,GitLab 是 gitlab.com 或自建域名,Bitbucket 则是 bitbucket.org 或 bitbucket.【必须核对实际域名后缀,自建 GitLab 实例若用 bitbucket 域名会误判】。
这一步不能跳过——飞书不会自动识别平台类型,错误选择将导致后续所有提示词字段引用失败。
GitHub 版本提示词生成
在提示词编辑框顶部选择「平台模板」→「GitHub」,系统自动注入以下预设变量占位符:
• {{pull_request.title}} → PR 标题
• {{pull_request.diff}} → 统一 diff 全量内容(含新增/删除行标记)
• {{file.filename}} → 当前被评论的文件路径(仅限行级评论上下文)
手动补全三处关键逻辑:在提示词开头加“你正在审查 GitHub Pull Request”,结尾强制要求输出格式为「文件路径 + 行号 + 建议」三元组,例如:src/utils/date.ts:42:建议改用 Intl.DateTimeFormat 避免时区 bug。
GitLab 版本提示词生成
方法一:使用内置 GitLab 模板
点击「平台模板」→「GitLab」,自动填入 {{merge_request.title}}、{{merge_request.changes}}(注意不是 diff,是 GitLab 特有的 changes API 结构化数组)、{{note.position.base_sha}}(用于定位对比基准)。
GInstall OneClick — 一键安装 GitHub 项目:规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
方法二:手动适配自建实例
若 GitLab 实例启用了相对路径代理(如 /gitlab/xxx),需在提示词中显式声明:「当前 MR 页面 URL 以 /gitlab/ 开头,所有路径引用需忽略该前缀」,否则模型可能把 /gitlab/group/proj/-/merge_requests/123 中的 /gitlab/ 误认为文件路径根目录。
Bitbucket 版本提示词生成
第一步:启用 Bitbucket 专用字段映射
在飞书智能伙伴后台「连接设置」中,勾选「启用 Bitbucket Cloud 兼容模式」,否则 {{pullrequest.description}} 将为空——Bitbucket 的 description 存在独立 API 端点,不勾选则无法加载。
第二步:替换 diff 引用方式
Bitbucket 不提供 raw diff 字符串,必须改用 {{pullrequest.rendered_diff}}(HTML 渲染版)或 {{pullrequest.patch}}(纯文本 patch)。推荐后者,因为模型对 \+/- 行前缀解析更稳定。
第三步:禁用行号强约束
Bitbucket 的评论锚点不支持精确到行号,提示词中必须删除所有「请标注 Lxx 行」类指令,改为「在涉及 [函数名] 的代码块附近给出建议」。

















