AgentSkillsCN

Concurrency

运用 Goroutine、Channel 和 Context，打造安全的并发编程规范。

SKILL.md
--- frontmatter
name: Concurrency
description: Standards for safe concurrent programming using Goroutines, Channels, and Context.
metadata:
  labels: [golang, concurrency, goroutines, channels, context, sync]
  triggers:
    files: ['**/*.go']
    keywords: [goroutine, go keyword, channel, mutex, waitgroup, context]

Golang Concurrency Standards

Priority: P0 (CRITICAL)

Principles

  • •Share Memory by Communicating: Don't communicate by sharing memory. Use channels.
  • •Context is King: Always pass ctx to efficient manage cancellation/timeouts.
  • •Prevent Leaks: Never start a goroutine without knowing how it will stop.
  • •Race Detection: Always run tests with go test -race.

Primitives

  • •Goroutines: Lightweight threads. go func() { ... }()
  • •Channels: For data passing + synchronization.
  • •WaitGroup: Wait for a group of goroutines to finish.
  • •ErrGroup: WaitGroup + Error propagation (Preferred).
  • •Mutex: Protect shared state (simpler than channels for just state).

Guidelines

  • •Buffered vs Unbuffered: Use unbuffered channels for strict synchronization. Use buffered only if you specifically need async decoupling/burst handling.
  • •Closed Channels: Panic if writing to closed. Reading from closed returns zero-value immediately.
  • •Select: Use select to handle multiple channels or timeouts.

References