概述
自定义 Kody 在代码审查开始和结束时发送的消息。此功能允许您个性化沟通风格并为团队添加特定的上下文或说明。默认行为
当您没有自定义任何消息时,Kody 的工作方式如下:- 初始消息:Kody 发送标准的开始审查消息
- 建议:Kody 提供所有代码审查建议
- 最终消息:Kody 用审查摘要更新初始消息
自定义消息行为
一旦您第一次编辑开始或结束审查消息,Kody 的行为将更改为:- 初始消息:Kody 发送您的自定义开始审查消息
- 建议:Kody 提供所有代码审查建议
- 最终消息:Kody 发送您的自定义结束审查消息(不更新初始消息)
消息配置选项
消息行为
使用消息行为下拉菜单来决定 Kody 何时发布您的自定义 开始和结束消息:-
重要提示：消息只会在审查实际运行时发送。
如果审查节奏为手动，消息仅会在有人运行@kody start-review时发送。 - 每次推送:Kody 在拉取请求打开时发布开始消息,并在每次触发审查的新推送后重复开始/结束对。
-
仅在打开时:Kody 仅在首次审查运行后发送一次开始和结束消息。如果审查节奏为手动，首次审查运行发生在执行
@kody start-review时。未来的推送只添加审查建议以及通常的反应,以便作者知道审查已重新运行。 - 关闭:自定义消息已禁用。Kody 仍会运行审查并发布建议,但不会发送开始或结束消息。
每次推送 或 仅在打开时 时,Kody 使用您填写的任何模板。如果您只自定义开始消息,则只发送该消息;结束消息也是如此。这保持了熟悉的初始消息 → 建议 → 最终消息时间线,只要行为允许发布消息。
示例（手动审查节奏）PR 打开 → 暂无消息
@kody start-review → 开始消息 → 建议 → 结束消息
动态上下文
您可以使用添加上下文按钮通过动态上下文增强自定义消息。这允许您包括:changedFiles
已更改文件的摘要,显示每个文件的添加和删除。这提供了拉取请求中修改内容的详细分解。changeSummary
拉取请求中所有更改的全面摘要,概述整个修改范围。reviewOptions
反映团队配置的审查设置,显示审查启用或禁用了哪些分析类型。reviewCadence
提供确切的后续审查策略,以便作者知道第一次自动审查后会发生什么:- 自动:Kody 在每次推送后立即重新审查。
- 自动暂停:Kody 自动重新审查推送,但如果检测到”推送突发”(例如,根据您的阈值,15 分钟内 3 次推送),它会暂停后续审查,直到您恢复它们。节奏上下文包括推送和时间限制,以便团队知道何时可以触发暂停。
- 手动:Kody 等待某人运行
@kody start-review后再进行另一次审查。
reviewScope
显示本次 pull request 的审查使用了哪个配置级别 —— 全局、代码库还是目录 —— 让作者知道 实际生效的是哪套设置。agentPrompt
仅用于结束审查消息。 它会打包本次审查的行级评论建议,而这些建议在审查跑完之前并不存在 ——
因此它不会出现在开始消息中。
当 Kody 发送消息时,这些上下文变量将自动填充来自您的拉取请求的实际数据。
在
kodus-config.yml 中,这些标记要带 @ 前缀书写 —— @changedFiles、
@changeSummary、@reviewOptions、@reviewCadence、@reviewScope、@agentPrompt ——
可以放在消息 content 内的任意位置。网页界面中的 Add Context 按钮会为你插入相同的标记。错误消息
与开始/结束消息这一对相互独立,你还可以在审查失败时,把自己的文本追加到 Kody 发布的 评论中 —— 例如未配置 BYOK 提供商,或提供商拒绝了请求时。- Off(默认)—— Kody 按原样发布标准错误评论。
- Active —— 你的文本会追加到标准错误评论下方。
content 留空则保持默认错误消息不变。
全局设置
两个开关,作用于 Kody 的所有评论,而不只是自定义消息:您始终可以通过禁用两个自定义消息或清除消息内容来恢复到默认行为。