跳转到主要内容
评审指令让你告诉 Kody 在单次评审中应把最深入的分析集中在哪里。你无需修改任何配置，只需在触发评审时附上一条简短说明——例如”聚焦于认证和会话逻辑”——Kody 便会把最严格的分析用在匹配的改动代码上。
指令是临时的：仅对该次评审运行生效。它不会保存到你的设置中，也不会影响后续评审。若要永久改变 Kody 的行为，请改用 Custom Prompts 或 Kody Rules。

​
何时使用

  • 一个 PR 改动了很多文件，但你最关心其中某个高风险区域（认证、支付、数据库迁移）。
  • 你希望 Kody 追踪某处改动的调用方与被调用方，并更严格地审视它。
  • 你在重新运行评审，想在不编辑任何配置的情况下引导注意力。

​
是优先级，而非过滤器

这是最需要理解的一点：
指令设定的是优先级，而不是过滤器。Kody 会优先关注聚焦区域，但仍会报告它在 diff 其他位置发现的任何具体缺陷、安全或性能问题。它绝不会隐藏聚焦之外的发现，也不会未经查看就批准 PR 的其余部分。
用指令来表达 “这里要最重点地看” ——而不是 “只看这里”。

​
如何触发

在拉取请求评论中，紧接评审命令之后写上你的聚焦文本：
@kody review 聚焦于认证和会话逻辑
你也可以使用 start-review，并与 --force 组合：
@kody start-review 聚焦于新的数据库迁移
@kody review --force 聚焦于 webhook 解析器的错误处理
只有命令之后的第一行会被用作指令。后续各行都会被忽略，因此请把聚焦内容写在一行内。
支持 GitHub、GitLab、Azure DevOps、Bitbucket 和 Forgejo。

​
如何写好一条指令

  • 明确区域，而非结论。“聚焦于队列消费者的并发”比”找出缺陷”更有效。
  • 指名代码，而非结果。 指向某个模块、流程或关注点（“重试逻辑”、“报表服务中的 SQL”）。
  • 保持简短。 指令上限为 500 个字符；只会读取评论的第一行。
  • @kody review 聚焦于认证与令牌刷新流程
  • @kody review 聚焦于新的 Stripe webhook 处理
  • kodus review --focus "后台 worker 中的竞态条件"
  • @kody review 请仔细一点 —— 没有可优先的区域。
  • @kody review 只评论文件 X —— 指令不是过滤器；请用忽略路径来限定文件。

​
说明与限制

  • 长度： 指令会在 500 个字符处截断。
  • 仅第一行： 在 PR 评论中，只有命令之后的第一行会成为指令。
  • 设计上不信任： 由于任何能评论 PR 的人都可以提供指令，文本在使用前会被清洗（去除控制字符和尖括号）。这不会改变你的聚焦——只是防止文本篡改 Kody 的内部提示词。
  • 不持久化： 不会向你的仓库或组织设置写入任何内容。