/go-agent-development

name: go-agent-development
description: 编写 BK-CI Go Agent 代码时使用，例如 Agent API 调用、任务处理、并发模式、错误处理、日志记录和宿主侧工具开发。当用户要写 Go 构建机侧代码而不是后端 Kotlin 服务时优先使用。

Go Agent 开发

适用场景

• 编写或修改 Go Agent 代码
• 处理 Agent 与后端的 API 通信
• 实现任务处理、并发执行、错误恢复和日志记录
• 开发构建机侧辅助工具

不适用场景

• 后端 Kotlin / Java 微服务开发
• Dispatch 调度策略设计
• Worker 任务执行细节

快速指导

1. 这个 skill 关注的是 Go 侧开发习惯和实现方式，不替代 `agent-module-architecture` 的架构视角。 2. 写 Go Agent 代码时优先保证稳定性：错误处理、日志、重试、清理和并发边界要先想清楚。 3. 进程、任务、网络调用、goroutine 生命周期要一起看，不要只改局部函数。 4. 如果问题是 Agent 整体运行形态、Ask、升级或宿主侧链路，联动看 `agent-module-architecture`。 5. 如果问题是调度资源选择，联动看 `dispatch-module-architecture`。

高信号规则

• Go Agent 代码更偏宿主侧稳定性和长期运行能力
• 网络调用和后台 goroutine 一旦失控，影响通常比业务逻辑错误更大
• 日志要能帮助定位问题，而不是只留下表面现象

关键陷阱

• 只改 happy path，不补错误恢复和资源清理
• goroutine 启动容易，退出和异常恢复没管
• 把宿主侧问题和调度 / Worker 问题混在一起

延伸阅读

• 如果你在看 Agent 架构：再看 `agent-module-architecture`
• 如果你在看调度边界：再看 `dispatch-module-architecture`