内容提要
GoLand 2026.3 将 Air 设为默认 AI 工作区,支持 Codex、Claude Code、Junie 等代理。文章演示用代理构建 Stripe 风格 Webhook 接收服务:Codex 按 BRIEF.md 实现内存存储、签名校验与处理器,并在 diff 中逐行审查反馈;随后三个代理在各自 worktree 并行完成 SQLite 存储、重放窗口测试和 HTTP 客户端签名请求,再合并验证;最后用 goland-profiler 技能分析 CPU 性能,发现正则重复编译占 69% CPU,修复后基准快约 4.6 倍。
延伸解读
代理协作的关键:先定义“完成”标准
文章强调,在把任务交给代理之前,开发者需要先明确项目原则和“完成”的定义,比如只使用标准库、单一端点、签名校验规则等。这些内容写在 BRIEF.md 中,不仅让代理有据可依,也协调多个代理并行工作。如果范围模糊,代理容易偏离预期,增加后续审查成本。因此,花时间写好 brief 是提高代理产出质量的前提。
并行开发与合并:worktree 隔离降低冲突
文章演示了三个代理在各自 worktree 中并行完成 SQLite 存储、重放窗口测试和 HTTP 客户端签名请求。worktree 让每个代理拥有独立分支,避免相互干扰。合并时通过 cherry-pick 将更改应用到当前分支,再统一验证。这种方式适合任务间依赖较少的场景,但合并后仍需整体测试,因为各代理只验证了自己部分。
性能分析技能:让代理定位真实瓶颈
goland-profiler 技能让代理能使用 GoLand 的 profiler 记录 CPU 性能并读取热点路径。在示例中,代理发现 validateEventID 每次调用都编译正则表达式,占 69% CPU。修复后基准测试快约 4.6 倍,内存分配减少 80%。文章建议先让代理诊断,开发者确认后再修改,并可用火焰图自行验证,避免盲目接受代理结论。
审查代理代码:聚焦常见错误模式
文章列出 webhook 接收器容易出错的点,如签名比较应使用 hmac.Equal、校验原始请求体、拒绝过期时间戳、限制请求体大小、读取后恢复 body、幂等返回 200 OK 以及错误信息不泄露细节。开发者可以按这份清单审查代理生成的 diff,而不是逐行阅读。在 diff 中直接添加行内注释反馈,能更精确地指导代理修正。
Q&A
GoLand 2026.3 中的 Air 是什么?它支持哪些代理?
Air 是 GoLand 2026.3 引入的默认 AI 工作区,取代了 AI Assistant。它支持 Junie、Codex、Claude Code 以及任何支持 Agent Client Protocol (ACP) 的代理。
如何在 GoLand 中启动一个 Air 代理会话?
有三种方式:1) 点击主工具栏的 Agent 小部件,使用当前预设或选择其他代理;2) 通过 View | Tool Windows | Agent Sessions 打开工具窗口;3) 在 IDE 中任意位置按两次 Ctrl,输入请求后按 Enter,选中的代码会作为上下文。
在审查代理生成的 webhook 处理器代码时,应该重点检查哪些常见错误?
应检查:签名比较是否使用 hmac.Equal(常量时间比较);HMAC 是否覆盖原始请求体和时间戳;是否拒绝超过 5 分钟的时间戳以防重放;是否使用 http.MaxBytesReader 限制请求体大小;中间件读取 r.Body 后是否重置;重复事件是否返回 200 OK;错误响应是否只返回简短固定消息而细节记录到日志。
如何让多个代理并行处理任务而不互相干扰?
在 Agent Sessions 工具窗口中,为每个新会话选择 New Local Worktree 运行模式,这样每个会话会获得独立的 Git worktree 和分支。代理在各自的工作树中工作,完成后可以分别审查并合并。
goland-profiler 技能是什么?它如何帮助优化 Go 代码性能?
goland-profiler 是 Air 内置的技能,能让代理使用 GoLand 的性能分析工具记录 CPU 配置文件,分析热点路径和行级提示。例如,在演示中,代理发现 validateEventID 每次调用都编译正则表达式,导致 69% 的 CPU 占用;修复后基准测试快了约 4.6 倍。
在合并多个代理的工作成果后,如何验证整个服务是否正常工作?
合并后,使用 GoLand 的 HTTP 客户端发送签名测试请求,并通过响应检查验证状态码;使用数据库工具检查 SQLite 中事件是否只存储一次;最后运行所有测试和基准测试,确保通过。