用途
这是一个用于协调有界代码审查的技能。当你需要从多个相关视角(如正确性、授权和性能)审查一个已定义的代码差异(diff)或子系统时,可以使用本技能。
需要说明的是,本技能描述的是一套审查程序,它不会安装编排引擎,也不能证明合规性。
主要能力
- 从多个相关视角协调对指定代码差异的审查。
- 支持在获授权时使用独立智能体进行并行审查,或在宿主不支持时按顺序依次进行各视角审查。
- 提供结构化的审查流程:阅读完整 diff、选择相关视角、分配有界审查任务、记录发现、复现重要问题、去重、解决分歧、输出结果。
- 强调以证据为中心:发现须包含确切位置、触发条件、后果和复现方式;假设与已验证的失败需分开记录。
- 要求先返回阻塞性问题,再返回重要改进和未测试区域。
使用方式
输入与执行范围
- 固定仓库/基线/头部、变更路径、预期行为和可用测试。
- 仅当用户授权委派且宿主支持时,才使用独立智能体;否则按顺序依次进行各视角审查。
- 不要仅因为本可调用 ID 中包含“multi-agent”就生成智能体。
- 只读审查是默认模式;修复、对外发布和部署仍须在用户实际任务授权范围内。
审查流程
- 阅读完整 diff 以及直接受影响的调用路径和测试。
- 只选择与本次变更相关的视角。为每个获授权的审查者分配一个有界问题、负责路径、时间/精力限制和预期的证据格式。
- 记录发现,包含确切位置、触发条件、后果和复现方式。将假设与已验证的失败分开;不要虚构置信度分数。
- 集中复现重要发现。按根因去重,而不是按措辞去重。
- 通过代码或测试解决分歧。加权投票和多个智能体重复同一主张不能作为正确性的证据。
- 先返回阻塞性问题,再返回重要改进和未测试区域。保留原始失败结果;重新运行不会抹去它。
示例
针对一个租户范围的缓存变更,审查键的构造、授权上下文和失效逻辑。复现两个租户请求同一个提示(prompt),以及同一租户内请求不同提示版本的情况。预期结果:只有当确实可能发生跨范围命中或陈旧结果时,才形成一个发现,并给出能展示该问题的最小案例。一般性的风格意见不得被呈现为数据暴露缺陷。
适用场景
- 需要对一个已定义的代码差异或子系统进行多视角审查时。
- 需要在正确性、授权、性能等方面进行结构化代码审查时。
- 需要以证据为中心、可复现的审查流程时。
限制
- 不附带智能体路由代码,不附带合规验证器,也不附带质量评分计算器。
- 并行审查会增加成本,并可能重复盲点。
- 本程序无法仅凭一个 diff 证明整个仓库的安全性。
- 本程序无权授权生产环境负载测试或消息发送。