Skip to main content
自定义提示让您完全控制 Kody 如何分析代码和沟通发现。定制 AI 在每个审查类别中查找的内容,以及如何呈现建议以匹配团队的标准和沟通风格。

访问自定义提示设置

为组织中的所有代码库配置自定义提示

​
为什么使用自定义提示?

团队特定标准

使 Kody 的审查与团队独特的编码标准、架构模式和最佳实践保持一致

模型优化

在使用 BYOK 时,为特定 AI 模型的优势精心设计提示

焦点控制

将 Kody 的注意力引导到对项目最重要的问题上并减少噪音

沟通风格

自定义 Kody 如何呈现建议 - 对关键问题详细或对次要问题简洁

​
自定义提示如何工作

自定义提示在两个级别运行:

​
类别提示

定义 Kody 在每个审查类别中查找的内容:
**焦点:**代码正确性和执行问题默认覆盖范围:
  • 执行中断(未处理的异常)
  • 错误结果(不正确的输出)
  • 资源泄漏(文件、连接、内存)
  • 状态损坏(无效的对象/数据状态)
  • 逻辑错误(不正确的控制流)
  • 竞态条件(并发访问问题)
**最大长度:**2000 字符

​
建议提示

控制 Kody 如何沟通每个单独的建议。这自定义了出现在 PR 评论中的消息格式和语气,例如:
您的自定义提示指示 Kody 如何编写建议消息。提示接收有关严重性级别、问题描述、建议代码以及是否为 Kody 规则违规的上下文。Kody 使用此上下文以及您的提示为每个建议生成适当的消息。 您可以根据团队的需求自定义语气、详细程度和沟通风格 - 从关键问题的详细解释到次要问题的简洁反馈。

​
外部引用

所有自定义提示——类别、建议和 PR 摘要——都支持引用 Kody 可以访问的代码库中的真实文件。当您保存更新时,Kody 会自动检测外部引用并为将来的审查解析它们。
  • 使用 @file:path/to/file.ts 指向您正在编辑的代码库中的文件;Kody 将首先尝试在本地找到路径。
  • 在引用另一个代码库中的文件或在全局级别编辑提示时包含 @repo:org/project。
  • 首选精确的 blob 样式路径而不是占位符,以便模型可以可靠地找到正确的文件。
  • 保存后,Kody 在后台处理引用。检查提示编辑器旁边的状态指示器以确认解析何时完成。

​
最佳实践

​
对上下文要具体

做:上下文特定

不要:太通用

​
避免提示之间的冗余

每个类别应该有不同的焦点。不要在不同的提示中重复相同的指令。
错误类别: 专注于执行正确性、Java 服务中的空指针异常和资源清理。安全类别: 专注于 API 端点中的 SQL 注入、XSS 和 CSRF。验证输入清理和参数化查询。性能类别: 专注于 N+1 查询、缺少数据库索引和数据处理中的低效循环。**结果:**每个提示都有清晰、不重叠的焦点。
错误类别: 检查空指针、SQL 注入和慢查询。安全类别: 查找 SQL 注入、空指针和性能问题。性能类别: 查找慢查询、空指针和安全漏洞。**问题:**所有提示重叠,使模型混淆并降低审查质量。

​
小心使用示例

这广泛描述了模式,捕获多个变体。

​
保持建议可扫描

对于建议提示,使消息易于扫描,因为开发人员一次审查许多:
清晰的层次结构,重要信息优先

​
有意义地使用上下文

仅在有真正原因时区分建议格式:
清晰的区别:规则是要求,建议是建议

​
用例

**场景:**具有 HIPAA 合规要求的医疗保健应用程序自定义安全提示:
**好处:**Kody 捕获通用安全审查可能错过的特定合规问题。
**场景:**具有特定模式的 React/Node.js 应用程序自定义错误提示:
**好处:**审查专注于您的技术栈的特定陷阱。
**场景:**通过 BYOK 使用 Gemini 2.5 Flash 进行成本优化自定义性能提示:
**好处:**Gemini 处理得非常好的结构化输出格式,提高审查质量。
**场景:**想要对关键问题进行详细解释但对次要问题进行简洁反馈自定义建议提示:
**好处:**关键问题获得额外的上下文,而次要问题保持简短,提高审查效率。
**场景:**团队更喜欢最少、可操作的反馈自定义建议提示:
**好处:**每个建议都简短到位,没有额外的上下文。
**场景:**初级开发人员从详细解释中受益自定义建议提示:
**好处:**每个建议都包括有关重要性的教育背景。
**场景:**Kody 规则是严格要求,建议是建议自定义建议提示:
**好处:**强制规则和可选建议之间的明确区别。

​
故障排除

**症状:**自定义后太多低价值建议解决方案:
  • 使提示更具体和集中
  • 为您想要忽略的模式添加排除项
  • 在建议控制中提高最低严重性阈值
  • 检查类别提示之间的冗余
**症状:**Kody 没有捕获应该捕获的问题解决方案:
  • 审查您的提示是否太窄或示例特定
  • 检查问题是否属于您未自定义的类别
  • 尝试重置为默认以查看是否捕获问题
  • 考虑问题是否可能被分类在不同的严重性下
**症状:**有时标记相同类型的问题,但并非总是如此解决方案:
  • 确保提示清晰明确
  • 删除不同提示之间的冲突指令
  • 检查您是否使用太具体的示例
  • 考虑主/后备中的不同模型是否具有不同的功能
**症状:**想要使用自定义提示但不确定从哪里开始解决方案:
  • 先运行默认审查一周
  • 注意误报或遗漏问题的模式
  • 仅自定义与这些模式相关的特定提示
  • 保持其他提示为默认,直到您看到明确的需求

​
常见问题

这取决于您在哪里设置它们:
  • **全局设置:**适用于组织中的所有代码库
  • **每个代码库设置:**覆盖该特定代码库的全局设置
这使您可以拥有组织范围的标准,并在需要时进行特定于代码库的覆盖。
可以。点击设置中的任何提示以查看默认内容。
更改仅影响新审查。使用 @kody start-review 重新运行以将新提示应用于现有 PR。
不可以。自定义提示仅限网页以确保有意更改。其他设置(忽略的路径、分支)可以使用 kodus-config.yml。
仅自定义具有明确、特定需求的提示。保持其他提示为默认以受益于我们的改进。从 1-2 个提示开始。
无缝工作。根据模型的优势定制提示。主和后备都使用相同的自定义提示。
类别提示控制 Kody 在每个审查类别中分析什么。建议提示控制 Kody 如何向团队呈现发现。您可以独立自定义两者。
可以。建议提示支持标准 markdown 格式,包括粗体、斜体、代码块和链接。
Kody 将回退到默认建议格式并在设置中通知您错误。
可以。使用 isKodyRule 变量在同一提示中为规则 vs. 建议创建不同的消息。