SuperAPI AI 工具集

go-agent-development

编程与开发

查看项目

更新于 10-16 04:39

技能介绍

用途

该技能面向 BK-CI 的 Go Agent 开发,适用于编写或修改 Go Agent 代码、处理 Agent 与后端的 API 通信、实现任务处理、并发执行、错误恢复和日志记录,以及开发构建机侧辅助工具。当用户要写 Go 构建机侧代码而不是后端 Kotlin 服务时,优先使用本技能。

主要能力

技能关注 Go 侧开发习惯和实现方式,强调宿主侧稳定性和长期运行能力。核心要点包括:编写 Go Agent 代码时优先保证稳定性,先想清楚错误处理、日志、重试、清理和并发边界;将进程、任务、网络调用、goroutine 生命周期放在一起考虑,而不是只改局部函数;日志要能帮助定位问题,而不是只留下表面现象。

使用方式

该技能不替代 agent-module-architecture 的架构视角。如果问题是 Agent 整体运行形态、Ask、升级或宿主侧链路,建议联动查看 agent-module-architecture;如果问题是调度资源选择,建议联动查看 dispatch-module-architecture。

适用场景

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

限制与不适用场景

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

关键陷阱

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

延伸阅读

  • 如果关注 Agent 架构:再看 agent-module-architecture
  • 如果关注调度边界:再看 dispatch-module-architecture