用途
Qodo Merge（原名 PR-Agent）用于在代码协作流程中引入 AI 能力，主要面向拉取请求（Pull Request）的审查与描述生成。该技能的目标是帮助用户安装、配置和排查 Qodo Merge，同时避免把大量产品文档拉入当前上下文。
主要能力
Qodo Merge 提供一组命令，覆盖 PR 生命周期的多个环节：
/describe：生成 PR 标题、摘要、走查说明、标签，以及可选的图表。/review：从质量、正确性、安全性和工单对齐等角度审查 PR。/improve：生成内联代码建议，并按置信度排序。/ask "..."：就 PR 的差异、文件或意图提问。/add_docs：为变更的代码补充缺失的文档。/generate_labels：根据 PR 内容推断标签。/help_docs "..."：基于项目文档回答仓库相关问题。
使用方式
使用该技能时，建议先明确两件事：
- 平台：GitHub Action/App、GitLab、Bitbucket、Azure DevOps、Docker、AWS Lambda 或自托管。
- 任务：安装、配置、使用某个工具命令、切换模型，或调试失败。
配置方面，优先使用仓库本地的 .pr_agent.toml 保存稳定设置，环境变量仅用于密钥或一次性覆盖。配置优先级为：命令行参数 -> 环境变量 -> .pr_agent.toml -> 默认值。环境变量覆盖时，配置键使用双下划线映射，例如 PR_REVIEWER__REQUIRE_TESTS_REVIEW=false。AWS Lambda 的环境变量不能包含 .，需用 __ 代替。非 OpenAI 提供商使用各自的 API 密钥，Claude、Gemini 等提供商不需要 OPENAI_KEY。
/improve 的激进程度由 suggestions_score_threshold 控制，提高该值可减少低价值建议。allow_dynamic_context = true 可通过扩展周边代码上下文来帮助处理较大的差异。若希望生成的 PR 正文贴合仓库模板，可使用描述标记。本地 Ollama 部署通常需要自托管运行器，因为托管 CI 无法访问本地服务。
适用场景
适用于需要在多种代码托管平台上自动化 PR 审查、描述生成、内联建议、标签推断和文档补充的团队。也适用于需要按平台和任务进行最小化配置、并快速排查常见问题的场景。
限制与排查
常见问题及首要检查项：
- 模型未找到：检查提供商特定的模型名称格式。
- API 密钥缺失：检查所选提供商对应的密钥/环境变量名称。
- 权限被拒绝：检查集成中的 PR、issue 和 contents 写入权限。
- 提供商配置中的 JSON 错误：检查
litellm.extra_body格式。 - 大型 PR 上下文不足：检查动态上下文和补丁大小设置。
关于精确选项名称和当前行为，应以官方文档 https://qodo-merge-docs.qodo.ai/ 为准。
参考文件路由
- 安装与平台特定设置：
references/installation.md - 工具行为与各工具配置：
references/tools.md .pr_agent.toml、CLI 标志、环境变量、模型接线：references/usage-guide.md- 自反思、压缩、动态上下文、元数据：
references/core-abilities.md - 产品概览、FAQ 及其他细节：
references/other.md - 镜像文档索引：
references/documentation/index.md
建议只读取与当前任务匹配的参考文件，而不是加载全部内容。回答应聚焦实现：选择正确的平台路径，展示最小配置，只解释与用户情况相关的选项。