개발 스킬

git 워크플로우 관행을 구조화합니다. 코드 변경 시 사용합니다. 커밋, 브랜칭, 충돌 해결 시 또는 여러 병렬 스트림에서 작업을 구성해야 할 때 사용합니다. 릴리스를 생성하거나, 시맨틱 버전 범프를 선택하거나, 태깅하거나, 체인지로그를 작성할 때 사용합니다.

사용자가 GitHub Actions 워크플로우, 워크플로우 구문, 트리거, 매트릭스, 러너, 재사용 가능한 워크플로우, 아티팩트, 캐싱, 시크릿, OIDC, 배포, 사용자 정의 액션 또는 Actions Runner Controller를 작성, 설명, 사용자 정의, 마이그레이션, 보안 설정 또는 문제 해결하는 방법을 묻고, 특히 공식 GitHub 문서, 정확한 링크 또는 문서 기반 YAML 지침이 필요할 때 사용합니다.

원시 메모, 오류 로그, 음성 받아쓰기 또는 스크린샷을 명확한 GitHub-flavored 마크다운 이슈 보고서로 변환합니다. 사용자가 버그 정보, 오류 메시지 또는 비공식 설명을 붙여넣고 구조화된 GitHub 이슈를 원할 때 사용합니다. 시각적 증거를 위한 이미지/GIF를 지원합니다.

Golang 벤치마킹, 프로파일링 및 성능 측정. Go 벤치마크를 작성, 실행 또는 비교하거나, pprof로 핫 경로를 프로파일링하고, CPU/메모리/트레이스 프로파일을 해석하며, benchstat로 결과를 분석하고, CI 벤치마크 회귀 탐지를 설정하거나, Prometheus 런타임 메트릭으로 프로덕션 성능을 조사할 때 사용합니다. 또한 개발자가 특정 성능 지표에 대한 심층 분석이 필요할 때 사용합니다 - 이 스킬은 측정 방법론을 제공하며...

We need to translate the given text from English to Korean, preserving the name "golang-cli" and other technical terms. The instruction says: "Translate only the text inside <text>. Do not include the name unless it appears in the source text." The name "golang-cli" appears in the source text? Actually, the source text does not contain "golang-cli" explicitly; it says "Golang CLI application development." The name to preserve is "golang-cli" but it's not in the source. The instruction says "Do not include the name unless it appears in the source text." So we should not add it. Also preserve product names, protocol names, URLs, numbers, technical terms. No extra commentary. The text: "Golang CLI application development. Use when building, modifying, or reviewing a Go CLI tool — especially for command structure, flag handling, configuration layering, version embedding, exit codes, I/O patterns, signal handling, shell completion, argument validation, and CLI unit testing. Also triggers when code uses cobra,

We need to translate the given text from English to Korean, preserving the specified name "golang-code-style" and other technical terms. The instruction says to translate only the text inside <text>, and not include the name unless it appears in the source text. The name "golang-code-style" appears in the source? Actually, the source text does not contain "golang-code-style" explicitly; it's the directory item name. The instruction says "Do not include the name unless it appears in the source text." So we should not add it. The source text has references to other skills like "samber/cc-skills-golang@golang-naming" etc. Those should be preserved as is. We need to translate the description of the skill. The text describes what the skill is about: Go code style conventions, line length, variable declarations, etc. And it says when to use it and what it's not for, with cross-references. We'll produce a natural Korean translation. Keep technical terms like "Go", "linter", "doc comments" as is

Go 언어 동시성 패턴. 고루틴, 채널, select, 락, 동기화 기본 요소, errgroup, singleflight, 워커 풀, 팬아웃/팬인 파이프라인을 포함한 동시성 Go 코드를 작성하거나 검토할 때 사용합니다. 또한 고루틴 누수, 경쟁 조건, 채널 소유권 문제를 감지하거나 채널과 뮤텍스 중에서 선택해야 할 때도 활성화됩니다.

Go 언어에서 관용적인 context.Context 사용법 — API 경계를 통한 전파, 취소, 타임아웃 및 데드라인, 요청 범위 값, 요청보다 오래 지속되는 백그라운드 작업을 위한 context.WithoutCancel. 계층 간 컨텍스트 전파를 설계하거나, 누수되거나 만료되지 않은 컨텍스트를 디버깅하거나, context.Background/TODO/WithoutCancel 중 선택하거나, 컨텍스트에 값을 저장할 때 적용합니다. 단순히 ctx를 첫 번째 매개변수로 받는 코드에는 해당하지 않습니다.

CI/CD 파이프라인 구성: Golang 프로젝트용 GitHub Actions 활용 — 테스팅, 린팅, SAST, 보안 스캐닝, 코드 커버리지, Dependabot, Renovate, GoReleaser, 코드 리뷰 자동화 및 릴리스 파이프라인. Go 프로젝트 CI 설정 또는 개선, GitHub Actions 워크플로 구성, 린터 또는 보안 스캐너 추가, 의존성 업데이트 자동화, 품질 게이트 추가 시 사용.

Golang 데이터 구조 — 슬라이스(내부 구조, 용량 증가, 사전 할당, slices 패키지), 맵(내부 구조, 해시 버킷, maps 패키지), 배열, container/list/heap/ring, strings.Builder vs bytes.Buffer, 제네릭 컬렉션, 포인터(unsafe.Pointer, weak.Pointer), 복사 의미론. Go 데이터 구조 선택 또는 최적화, 제네릭 컨테이너 구현, container/ 패키지 사용, unsafe 또는 weak 포인터 사용, 슬라이스/맵 내부 구조에 대한 질문 시 사용합니다.

Go 데이터베이스 접근에 대한 종합 가이드 — 매개변수화된 쿼리, 구조체 스캐닝, NULL 가능 컬럼, 트랜잭션, 격리 수준, SELECT FOR UPDATE, 연결 풀, 배치 처리, 컨텍스트 전파, 마이그레이션 도구. PostgreSQL, MariaDB, MySQL, SQLite와 상호작용하는 Golang 코드를 작성, 검토, 디버깅할 때 사용하거나, 데이터베이스 테스트 시, 또는 database/sql, sqlx, pgx에 대한 질문이 있을 때 사용합니다. 데이터베이스 스키마나 마이그레이션 SQL은 생성하지 않습니다.

Golang에서 의존성 주입(DI)에 대한 종합 가이드입니다. DI가 중요한 이유(테스트 용이성, 느슨한 결합, 관심사 분리, 생명주기 관리), 수동 생성자 주입, DI 라이브러리 비교(google/wire, uber-go/dig, uber-go/fx, samber/do)를 다룹니다. 서비스 아키텍처 설계, 의존성 주입 설정, 강하게 결합된 코드 리팩토링, 싱글톤 또는 서비스 팩토리 관리 시, 또는 사용자가 제어 역전, 서비스...에 대해 질문할 때 이 스킬을 사용하세요.

Golang 프로젝트의 의존성 관리 전략 — go.mod 관리, 패키지 설치/업그레이드, 최소 버전 선택, 취약점 스캔, 오래된 의존성 추적, 바이너리 크기 분석, Dependabot/Renovate 설정, 충돌 해결, go.work 워크스페이스. Go 의존성을 추가, 제거 또는 업그레이드하거나, 취약점을 감사하거나, 버전 충돌을 해결하거나, 자동 의존성 업데이트를 설정할 때 사용합니다.

관용적인 Golang 디자인 패턴 — 함수형 옵션, 생성자, 오류 흐름 및 연쇄, 리소스 관리 및 생명주기, 정상 종료, 복원력, 아키텍처, 의존성 주입, 데이터 처리, 스트리밍 등. 아키텍처 패턴을 명시적으로 선택할 때, 함수형 옵션을 구현할 때, 생성자 API를 설계할 때, 정상 종료를 설정할 때, 복원력 패턴을 적용할 때, 또는 특정 문제에 맞는 관용적인 Go 패턴을 질문할 때 적용하세요.

Golang 프로젝트를 위한 포괄적인 문서 가이드로, godoc 주석, README, CONTRIBUTING, CHANGELOG, Go Playground, Example 테스트, API 문서, llms.txt를 다룹니다. 문서 주석이나 문서를 작성하거나 검토할 때, 코드 예제를 추가할 때, 문서 사이트를 설정할 때, 또는 문서 모범 사례에 대해 논의할 때 사용합니다. 라이브러리와 애플리케이션/CLI 모두에 적용됩니다.

관용적인 Golang 오류 처리 — 생성, %w를 사용한 래핑, errors.Is/As, errors.Join, 사용자 정의 오류 타입, 센티널 오류

We need to translate the given English text into Korean, preserving specific terms like "golang-google-wire" (but it's not in the text, only in the instruction). The text is about compile-time dependency injection in Golang using google/wire. We must not include the name unless it appears in the source text. The source text includes "google/wire", "wire.NewSet", etc. We need to translate the description naturally while keeping technical terms like "wire.NewSet", "wire.Build", etc. as they are. Also preserve URLs? There is no URL. Numbers? None. Technical terms: "compile-time dependency injection", "Golang", "google/wire", "wire.NewSet", "wire.Build", "wire.Bind", "interface→concrete", "wire.Struct", "wire.Value", "wire.InterfaceValue", "wire.FieldsOf", "cleanup functions", "//go:build wireinject injector files", "generated wire_gen.go", "runtime DI with reflection". Also the last part "see

Implements GraphQL APIs in Golang using gqlgen or graphql-go. Apply when building GraphQL servers, designing schemas, writing resolvers, handling subscriptions, or integrating GraphQL with existing Go HTTP services. Also apply when the codebase imports `github.com/99designs/gqlgen` or `github.com/graph-gophers/graphql-go`.

gRPC 사용 지침, protobuf 구성, Golang 마이크로서비스를 위한 프로덕션 준비 패턴을 제공합니다. gRPC 서버/클라이언트 구현, 검토, 디버깅, proto 파일 작성, 인터셉터 설정, 상태 코드로 gRPC 오류 처리, TLS/mTLS 구성, bufconn으로 테스트, 스트리밍 RPC 작업 시 사용하세요.

Golang 스킬 오케스트레이터 — 모든 Golang 코딩, 리뷰, 디버그 또는 설정 작업에서 항상 활성화됩니다. 작업 컨텍스트를 읽고 samber/cc-skills-golang에서 가장 관련성 높은 스킬을 로드하며, 종종 여러 개를 동시에 로드합니다: gRPC 서비스 작성 시 golang-grpc + golang-testing + golang-error-handling 로드; 패닉 디버깅 시 golang-troubleshooting + golang-safety 로드; 보안 감사 시 golang-security + golang-lint + golang-safety 로드. 또한: 두 스킬이 겹치는 것으로 보일 때 경쟁 클러스터를 명확히 구분합니다...

Golang 프로젝트를 위한 린팅 모범 사례와 golangci-lint 설정 — 린터 실행, .golangci.yml 구성, nolint 지시어로 경고 억제, 린트 출력 해석, 린터 선택. golangci-lint를 구성할 때, 린트 경고나 nolint 억제에 대해 질문할 때, 코드 품질 도구를 설정할 때, 또는 린터를 선택할 때 사용합니다. 또한 사용자가 golangci-lint, go vet, staticcheck, revive를 언급할 때 사용합니다.

golang-linter — AI 에이전트를 위한 설치 가능한 스킬입니다.

Go 코드를 최신 언어 기능, 표준 라이브러리 개선 사항, 관용적 패턴을 사용하도록 현대화합니다. Go 코드를 작성하거나 검토할 때 구식 패턴이 감지되거나, 사용 중단 경고가 발생하면 사전에 트리거됩니다. 또한 사용자가 명시적으로 현대화, Go 버전 업그레이드, 또는 CI/도구 새로고침을 요청할 때도 사용됩니다.

Go (Golang) 네이밍 규칙 — 패키지, 생성자, 구조체, 인터페이스, 상수, 열거형, 오류, 불리언, 리시버, 게터/세터, 함수형 옵션, 약어, 테스트 함수, 서브테스트 이름을 다룹니다. 새 Go 코드를 작성하거나, 코드 리뷰 또는 리팩토링 시, 네이밍 대안(New vs NewTypeName, isConnected vs connected, ErrNotFound vs NotFoundError, iota 0에서 StatusReady vs StatusUnknown) 중 선택하거나, Go 패키지 이름(utils/helpers 안티패턴)을 논의할 때 이 스킬을 사용하세요.

Golang 일상적인 관측 가능성 — 프로덕션에서 항상 켜져 있는 신호. slog를 사용한 구조화된 로깅, Prometheus 메트릭, OpenTelemetry 분산 추적, pprof/Pyroscope를 사용한 연속 프로파일링, 서버 측 RUM 이벤트 추적, 알림 및 Grafana 대시보드를 다룹니다. 프로덕션 모니터링을 위해 Go 서비스를 계측하거나, 메트릭 또는 알림을 설정하거나, OpenTelemetry 추적을 추가하거나, 로그와 추적을 연관시키거나, 레거시 로거(zap/logrus/zerolog)를 slog로 마이그레이션할 때 적용하세요.

Golang 성능 최적화 패턴 및 방법론 - X 병목이 발생하면 Y를 적용. 할당 감소, CPU 효율성, 메모리 레이아웃, GC 튜닝, 풀링, 캐싱, 핫패스 최적화를 다룹니다. 프로파일링이나 벤치마크에서 병목이 확인되어 이를 해결할 적절한 최적화 패턴이 필요할 때 사용합니다. 또한 성능 코드 리뷰 시 개선 사항이나 빠른 성능 향상을 식별하는 데 도움이 될 벤치마크를 제안할 때 사용합니다. 측정 방법론에는 해당하지 않습니다(→...

프로덕션에 적합한 Golang 라이브러리와 프레임워크를 추천합니다. 사용자가 명시적으로 라이브러리 제안을 요청하거나, 대안을 비교하려 하거나, 특정 작업에 맞는 라이브러리를 선택해야 하거나, 프로젝트에 새 종속성을 추가할 때 적용하세요.

Go 프로젝트 레이아웃과 워크스페이스 설정 가이드를 제공합니다. 새 Go 프로젝트를 시작하거나, 기존 코드베이스를 정리하거나, 여러 패키지가 있는 모노레포를 설정하거나, 여러 메인 패키지가 있는 CLI 도구를 만들거나, cmd/internal/pkg 디렉토리 규칙을 결정하거나, 패키지 재구성, 패키지 분할, 모듈 분할을 논의할 때 사용하세요.

방어적 Golang 코딩으로 패닉, 무음 데이터 손상, 미묘한 런타임 버그를 방지합니다. nil 패닉, append 앨리어싱, 맵 동시 접근, 부동소수점 비교 함정, 제로값 설계 질문을 마주할 때 사용합니다. 또한 nil 안전성, 숫자 변환 오버플로우, 리소스 생명주기 문제(루프 내 defer), 슬라이스와 맵의 방어적 복사를 위해 코드를 검토할 때도 사용합니다.

Golang에서 samber/do를 사용한 의존성 주입 — 서비스 컨테이너, 생명주기 관리, 스코프, 헬스 체크, 정상 종료, 모듈 구성. samber/do를 사용하거나 도입할 때, 코드베이스가 github.com/samber/do 또는 github.com/samber/do/v2를 임포트할 때, 또는 수동 생성자 주입을 DI 컨테이너로 리팩토링할 때 적용하십시오.