OpenParable
Skip to content
← Back to skills

Go Agent Development

Development
go-agent-development

Go Agent Development is an Agent Skill for development published in the TencentBlueKing/bk-ci repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-ci/blob/HEAD/ai/skills/go-agent-development/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/go-agent-development, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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