go-agent-development
A guide for developing robust Go-based agents, covering API communication, concurrency, and error handling.
Install
mkdir -p .claude/skills/go-agent-development && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4603" && unzip -o skill.zip -d .claude/skills/go-agent-development && rm skill.zipInstalls to .claude/skills/go-agent-development
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
编写 BK-CI Go Agent 代码时使用，例如 Agent API 调用、任务处理、并发模式、错误处理、日志记录和宿主侧工具开发。当用户要写 Go 构建机侧代码而不是后端 Kotlin 服务时优先使用。Key capabilities
- →Write or modify Go Agent code
- →Handle Agent API communication with the backend
- →Implement task processing and concurrent execution
- →Manage error recovery and logging
- →Develop auxiliary tools for the build machine
How it works
This skill guides Go Agent development by focusing on implementation standards for task execution, communication, and error handling.
Inputs & outputs
When to use go-agent-development
- →Develop Go build agents
- →Implement agent heartbeat logic
- →Debug agent communication
About this skill
Go Agent 开发
适用场景
- 编写或修改 Go Agent 代码
- 处理 Agent 与后端的 API 通信
- 实现任务处理、并发执行、错误恢复和日志记录
- 开发构建机侧辅助工具
不适用场景
- 后端 Kotlin / Java 微服务开发
- Dispatch 调度策略设计
- Worker 任务执行细节
快速指导
- 这个 skill 关注的是 Go 侧开发习惯和实现方式，不替代
agent-module-architecture的架构视角。 - 写 Go Agent 代码时优先保证稳定性：错误处理、日志、重试、清理和并发边界要先想清楚。
- 进程、任务、网络调用、goroutine 生命周期要一起看，不要只改局部函数。
- 如果问题是 Agent 整体运行形态、Ask、升级或宿主侧链路，联动看
agent-module-architecture。 - 如果问题是调度资源选择，联动看
dispatch-module-architecture。
高信号规则
- Go Agent 代码更偏宿主侧稳定性和长期运行能力
- 网络调用和后台 goroutine 一旦失控，影响通常比业务逻辑错误更大
- 日志要能帮助定位问题，而不是只留下表面现象
关键陷阱
- 只改 happy path，不补错误恢复和资源清理
- goroutine 启动容易，退出和异常恢复没管
- 把宿主侧问题和调度 / Worker 问题混在一起
延伸阅读
- 如果你在看 Agent 架构：再看
agent-module-architecture - 如果你在看调度边界：再看
dispatch-module-architecture
When not to use it
- →Backend Kotlin / Java microservice development
- →Dispatch scheduling strategy design
- →Worker task execution details
Limitations
- →Does not cover Agent module architecture
- →Does not cover Dispatch module architecture
- →Does not cover Worker task execution details
How it compares
This focuses on Go-specific development practices for host-side agents, rather than general backend service development or architectural design.
Compared to similar skills
go-agent-development side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| go-agent-development (this skill) | 2 | 3mo | No flags | Intermediate |
| workflow-orchestration-patterns | 10 | 2mo | No flags | Advanced |
| upgrading-golang | 1 | 5mo | Review | Intermediate |
| gentleman-system | 1 | 7mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
workflow-orchestration-patterns
wshobson
Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.
upgrading-golang
chainloop-dev
Upgrades Go version across the entire Chainloop codebase including source files, Docker images, CI/CD workflows, and documentation. Use when the user mentions upgrading Go, golang version, or updating Go compiler version.
gentleman-system
Gentleman-Programming
System detection and command execution patterns for Gentleman.Dots. Trigger: When editing files in installer/internal/system/, adding OS support, or modifying command execution.
agent-module-architecture
TencentBlueKing
Agent 构建机模块架构指南（Go 语言），涵盖 Agent 启动流程、心跳机制、任务领取执行、升级更新、与 Dispatch 交互。当用户开发 Agent 功能、修改心跳逻辑、处理任务执行或实现 Agent 升级时使用。
write-script-go
windmill-labs
MUST use when writing Go scripts.
gentleman-installer
Gentleman-Programming
Installation step patterns for Gentleman.Dots TUI installer. Trigger: When editing installer.go, adding installation steps, or modifying the installation flow.