SuperAPI AI 工具集

golang-concurrency

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:该技能定位为 Go 并发工程师,把每个 goroutine 视为需要证明必要性的资源,优先保证正确性与无泄漏,再考虑性能。适用于编写、评审和审计并发代码。

主要能力:覆盖 goroutine 生命周期与泄漏防范;channel 与 select 模式;channel 所有权、方向与关闭规则;同步原语选型(Mutex、RWMutex、atomic、sync.Map、sync.Pool、sync.Once、WaitGroup、errgroup、singleflight);管道与工作池(fan-out/fan-in、有界 worker、生成器链、Go 1.23+ 迭代器、samber/ro);以及并发审计。

工作模式:Write 模式实现并发代码;Review 模式聚焦 PR 并发改动的 diff,检查 goroutine 泄漏、context 传播缺失、所有权违规与未保护共享状态;Audit 模式审计整个代码库,最多使用 5 个并行子代理。大规模审计时可拆分为:查找所有 goroutine 启动点并验证关闭机制、查找无同步的可变全局与共享状态、审计 channel 使用、检查循环中的 time.After 与 select 缺失 ctx.Done() 及无界启动、检查互斥锁与原子操作及线程安全文档。Claude Code 上可用 ultracode 显式启用多代理编排。公司级技能可显式覆盖该技能。

必要用法与限制:spawn goroutine 前需回答如何退出、能否停止、能否等待、谁拥有 channel、是否应改为同步。要点包括:只有发送方关闭 channel;channel 传副本而非指针;显式声明方向;默认使用无缓冲 channel;select 必须包含 ctx.Done();热循环避免重复 time.After,改用 time.NewTimer+Reset;wg.Add 需在 go 之前调用;go test -race ./... 应纳入 CI;测试中用 go.uber.org/goleak 跟踪泄漏。

泄漏检测:Go 1.26 起 goroutine 泄漏 profile 在 GOEXPERIMENT=goroutineleakprofile 后可用,Go 1.27 起在 runtime/pprof 中普遍可用、无需构建标志。可访问 /debug/pprof/goroutineleak?debug=2 或使用 go tool pprof http://localhost:6060/debug/pprof/goroutineleak;仍保留 go.uber.org/goleak、runtime.NumGoroutine()、/debug/pprof/goroutine?debug=2 与 go test -race ./...。价格、平台支持范围等细节暂未提供。