自定义消息

​

概述

自定义 Kody 在代码审查开始和结束时发送的消息。此功能允许您个性化沟通风格并为团队添加特定的上下文或说明。

​

默认行为

当您没有自定义任何消息时,Kody 的工作方式如下:

1. 初始消息:Kody 发送标准的开始审查消息
2. 建议:Kody 提供所有代码审查建议
3. 最终消息:Kody 用审查摘要更新初始消息

​

自定义消息行为

一旦您第一次编辑开始或结束审查消息,Kody 的行为将更改为:

1. 初始消息:Kody 发送您的自定义开始审查消息
2. 建议:Kody 提供所有代码审查建议
3. 最终消息:Kody 发送您的自定义结束审查消息(不更新初始消息)

这创建了一个完整的时间线:初始消息 → 建议 → 最终消息

​

消息配置选项

​

消息行为

使用消息行为下拉菜单来决定 Kody 何时发布您的自定义 开始和结束消息:

• 每次推送:Kody 在拉取请求打开时发布开始消息,并在每次触发审查的新推送后重复开始/结束对。
• 仅在打开时:Kody 仅在 PR 打开后发送一次开始和结束消息。未来的推送只添加审查建议以及通常的反应,以便作者知道审查已重新运行。
• 关闭:自定义消息已禁用。Kody 仍会运行审查并发布建议,但不会发送开始或结束消息。

当行为是 每次推送 或 仅在打开时 时,Kody 使用您填写的任何模板。如果您只自定义开始消息,则只发送该消息;结束消息也是如此。这保持了熟悉的初始消息 → 建议 → 最终消息时间线,只要行为允许发布消息。

​

动态上下文

您可以使用添加上下文按钮通过动态上下文增强自定义消息。这允许您包括:

​

changedFiles

已更改文件的摘要,显示每个文件的添加和删除。这提供了拉取请求中修改内容的详细分解。

​

changedSummary

拉取请求中所有更改的全面摘要,概述整个修改范围。

​

reviewOptions

反映团队配置的审查设置,显示审查启用或禁用了哪些分析类型。

​

reviewCadence

提供确切的后续审查策略,以便作者知道第一次自动审查后会发生什么:

• 自动:Kody 在每次推送后立即重新审查。
• 自动暂停:Kody 自动重新审查推送,但如果检测到”推送突发”(例如,根据您的阈值,15 分钟内 3 次推送),它会暂停后续审查,直到您恢复它们。节奏上下文包括推送和时间限制,以便团队知道何时可以触发暂停。
• 手动:Kody 等待某人运行 @kody start-review 后再进行另一次审查。