要让Cursor输出适配多平台的代码评审意见,必须在提示词中显式声明目标平台及元数据结构:GitHub需path/line/body JSON格式并禁用相对路径;GitLab需含base_sha的position对象且启用diff-aware模式;Bitbucket强制inline单行评论、禁用表格与resolved表述。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让cursor在代码评审中输出适配不同平台(如github pr、gitlab mr、bitbucket diff、内部code review系统)的格式化意见,必须在提示词里显式声明目标平台及其元数据结构——github要求意见带review_comment字段和line锚点,gitlab则需position对象含base_sha,bitbucket强制使用inline模式且不支持多行引用。
GitHub平台专用评审提示词写法
第一步:在提示词开头插入平台标识块
【目标平台】GitHub Pull Request Review → 必须输出JSON数组,每项含path、line、body三字段,line值必须为整数,不可为范围(如"42-45")。
第二步:绑定GitHub API约束
所有意见必须符合GitHub REST API v3 POST /repos/{owner}/{repo}/pulls/{pull_number}/comments 的请求体规范;若检测到if嵌套超过3层,必须在body中插入<details><summary>展开查看重构建议</summary>...</details>折叠块,否则前端渲染会截断内容。
第三步:禁用本地路径别名
【禁止使用】“当前文件”“本模块”“上文”等相对指代——必须写成src/main/java/com/example/auth/JwtFilter.java:87完整路径+行号,GitHub审查界面不解析相对上下文。
GitLab平台专用评审提示词写法
方法一:强制position结构
每条意见开头必须以position:起始,后接JSON对象:{"base_sha":"a1b2c3d","start_line":22,"end_line":22,"old_path":"utils/validator.py","new_path":"utils/validator.py"}。注意base_sha不可省略,GitLab MR评论接口校验失败将直接拒收整批意见。
方法二:启用diff-aware模式
在提示词中追加:“当检测到+ def validate(self):新增行时,自动提取前导空格数并匹配- def check(self):删除行缩进,仅对缩进一致的增删行对生成对比意见”。这能避免GitLab在合并预览页把意见错挂到错误行。
Bitbucket平台专用评审提示词写法
Bitbucket只接受inline评论,必须满足三个硬性条件:每条评论content字段长度≤500字符;禁止出现Markdown表格;所有代码引用必须用```python包裹且仅限单行。例如检测到for item in data:,意见只能写:
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。
for item in (data or []):
,不能展开为多行修复示例。
这一步操作起来很简单,直接把文件拖进去就行。
注意:Bitbucket不支持resolved状态标记,所有意见默认为open,因此提示词中禁用“请确认后关闭此意见”类表述,否则会误导评审人。










