Skip to content

feat(agent-core-v2): run auto review in read-only agents - #5177

Draft
7Sageer wants to merge 1 commit into
auto-reviewfrom
feat/auto-review-agent
Draft

7Sageer wants to merge 1 commit into
auto-reviewfrom
feat/auto-review-agent

Conversation

@7Sageer

@7Sageer 7Sageer commented Nov 20, 2026

Copy link
Copy Markdown
Collaborator

Requirement or Bug

在 #4655 的实验性 Auto Review 基础上,让每次工具调用复核由一个临时的只读 subagent 完成。Write 和 Edit 跳过复核,其余符合送审条件的工具调用沿用原有审批与拒绝流程。

Stacked on #4655;本 PR 的 base 是 auto-review,diff 只包含这项后续改动。

Bug Reproduction Steps

N/A

Root Cause

N/A

Code Changes

核心思路:复用现有 Agent 生命周期和只读 explore profile 承载 reviewer。每次尝试创建独立 subagent,继承调用方的环境与目录,提交复核 prompt,读取最终回复中的 JSON 决定,随后移除该 subagent。主 Agent 的授权上下文、风险判定和 allow / deny / failure 分流保持在 Auto Review 服务中。

sequenceDiagram
    participant Main as Main agent
    participant Review as Auto Review
    participant Reviewer as Temporary read-only subagent
    Main->>Review: Qualifying tool call
    Review->>Reviewer: Create with inherited environment and cwd
    Review->>Reviewer: Review policy and existing review context
    Reviewer-->>Review: JSON decision in final response
    Review->>Review: Validate decision and authorization snapshot
    Review->>Reviewer: Remove
    Review-->>Main: Apply existing permission outcome
Loading
 Auto Review trigger
+  skip Write and Edit
   preserve existing static-policy exclusions
 review attempt
-  construct a direct structured LLM request
+  create an explore-profile subagent
+  pin its permission mode to manual
+  run one review turn
+  parse and validate its final JSON response
+  remove the subagent in finally
  • packages/agent-core-v2/src/features/autoReview/autoReviewGate.ts:在送审入口排除 Write / Edit;其余触发条件和审批分流不变。
  • packages/agent-core-v2/src/features/autoReview/reviewService.ts:用 Agent 生命周期替换直接协议请求;保留模型选择、授权与 Git 状态输入、30 秒默认截止、最多 3 次尝试、4 路并发、取消、事件和用量记录。
  • packages/agent-core-v2/src/session/agentLifecycle/agentLifecycleService.ts:广播权限模式时识别 reviewer 标签,保持 reviewer 的 manual 模式。
  • 测试改为模拟 runAgentTurn 和 Agent 生命周期,覆盖 reviewer 创建、运行、清理、重试与权限模式隔离。
  • 中英文 auto_review 配置说明同步更新送审范围和只读 subagent 行为。
旧请求路径的功能去向
旧路径能力 本 PR 中的位置
[auto_review] model、[secondary_model]、主模型回退 保留原模型选择,并传入 reviewer 的模型绑定
当前 cwd、AGENTS.md、授权历史、历史工具调用、待审参数、Git 状态 保留 buildReviewMessages,与复核策略一起组成 subagent prompt
文本决定及本地交叉组合校验 从最终回复读取文本,沿用原 DecisionSchema
最多 3 次尝试、退避、30 秒默认截止、4 路并发、取消 保留外层复核控制,每次尝试运行一个独立 subagent
operation 用量、auto_review.started / auto_review.decision、遥测 保留原归属 Agent、事件和 request kind
reviewer 禁止执行工具 改用 explore 的只读工具集与 manual 权限;最终 JSON 校验保留
输出格式、thinking、输出预算、采样、缓存键 改由所选模型和 Agent profile 的常规请求路径决定,详见行为变化表

Behavior Changes and Affected Users

Behavior Before After Who relies on the old behavior Escape hatch
实验开启时 Write / Edit 的送审 未被更具体规则放行时可能进入 reviewer 跳过 Auto Review,继续走其他权限策略 开启实验、依赖 reviewer 复核这两类调用的 TUI、print、desktop/web、VS Code、ACP、SDK 用户 关闭实验 flag;配置 ask / deny 权限规则
其他工具的送审条件 Always Ask 会询问且未被更具体规则放行时送审 保持原条件 无 无需操作
reviewer 执行方式 无工具的直接 LLM 请求 每次尝试创建 explore 只读 subagent,继承当前环境与 cwd,结束后移除 开启实验的各客户端用户;远程环境中的 reviewer 也继承对应环境 关闭实验 flag
reviewer 权限模式广播 随会话广播切换到 auto / yolo 由 reviewer 标签识别并固定为 manual 开启实验、运行中切换权限模式的用户 无需操作,主 Agent 的模式切换保持不变
reviewer 回复契约 provider 收到 strict JSON Schema,本地校验拒绝工具调用 由 subagent 输出文本,本地继续校验完整 JSON 对象及风险/决定组合;非法输出按原规则重试 开启实验、使用不同 provider 方言的用户 关闭实验 flag;[auto_review] model 可选择其他模型
thinking、输出预算、采样与缓存 直接请求关闭 thinking,并单独解析输出预算、采样和 auto_review 缓存键 跟随所选模型和 Agent profile 的常规请求配置 开启实验并自定义模型参数的用户 [auto_review] model 可显式选择模型;关闭实验 flag
reviewer 可用的调查能力 reviewer 无工具,只依据注入上下文 reviewer 可用只读工具调查当前环境,再返回决定 开启实验、审查远程或本地工作区的用户 关闭实验 flag
模型、重试、超时、并发、取消、授权变化检测、事件和用量归属 已有行为 保持原有控制与分流 无 无需操作
Auto Review 文档 描述直接请求的送审范围与 thinking 行为 同步 Write / Edit 跳过、只读 subagent 和 profile 驱动的模型行为 阅读中英文配置文档的用户 无需操作

受影响模块与测试覆盖:

  • autoReviewGate:Write / Edit 跳过,Bash 仍触发复核。
  • reviewService:默认及显式模型、explore 绑定、manual 模式、运行后清理、授权与 Git 上下文、非法输出与限流重试、上下文溢出、超时、并发、取消、事件、用量和遥测。
  • AgentLifecycleService:广播 yolo 后主 Agent 切换、reviewer 保持 manual。
  • docs/en/configuration/config-files.md 与 docs/zh/configuration/config-files.md:双语结构一致,文档构建通过。
Validation
  • pnpm exec tsc -p packages/agent-core-v2/tsconfig.json --noEmit:通过。
  • pnpm exec vitest run --reporter=agent packages/agent-core-v2/test/features/autoReview/autoReview.test.ts packages/agent-core-v2/test/session/agentLifecycle/agentLifecycle.test.ts:2 个测试文件、84 项测试通过。
  • pnpm lint:0 errors / 0 warnings,导入边界、guards、ratchet 与说明文件检查通过。
  • pnpm --dir docs run build:通过;保留构建工具已有的 ES2024 target 和 chunk size 警告。
  • 完整 diff 经只读审查,未发现内部标识或凭据。
  • 尚未验证真实 provider 下的端到端复核;当前验证使用 Agent 生命周期与 runAgentTurn 测试替身。

Checklist

  • I have read the CONTRIBUTING document.
  • I have linked a related issue (external PRs: issue must have a maintainer's /approve). 关联父 PR feat(agent-core-v2): add experimental auto review and read-only Bash approvals #4655;本 PR 为同仓库 stacked Draft。
  • I have added tests that prove my feature works.
  • The behavior-change table above is complete, and every removed behavior or flipped default is named in the changeset and either has an escape hatch or was explicitly approved by a maintainer in this PR.
  • Ran gen-changesets skill, or this PR needs no changeset.
  • Ran gen-docs skill, or this PR needs no doc update. 已更新双语配置文档;base 分支没有该技能引用的 docs/scripts/sync-changelog.mjs,未改动发布变更记录。

@changeset-bot

changeset-bot Bot commented Nov 20, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 6a266c6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages
Name Type
@moonshot-ai/kimi-code Patch
kimi-code-app Patch
@moonshot-ai/agent-core-v2 Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant