SKILL.md
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