Skills Phát triển

Cấu trúc các thực hành quy trình làm việc git. Sử dụng khi thực hiện bất kỳ thay đổi mã nào. Sử dụng khi commit, tạo nhánh, giải quyết xung đột, hoặc khi bạn cần tổ chức công việc trên nhiều luồng song song. Sử dụng khi cắt một bản phát hành, chọn mức tăng phiên bản ngữ nghĩa, gắn thẻ, hoặc viết changelog.

Sử dụng khi người dùng hỏi cách viết, giải thích, tùy chỉnh, di chuyển, bảo mật hoặc khắc phục sự cố các luồng công việc GitHub Actions, cú pháp luồng công việc, trình kích hoạt, ma trận, trình chạy, luồng công việc tái sử dụng, tạo phẩm, bộ nhớ đệm, bí mật, OIDC, triển khai, hành động tùy chỉnh hoặc Bộ điều khiển Trình chạy Actions, đặc biệt khi họ cần tài liệu chính thức của GitHub, liên kết chính xác hoặc hướng dẫn YAML dựa trên tài liệu.

Chuyển đổi ghi chú thô, nhật ký lỗi, lời đọc chính tả hoặc ảnh chụp màn hình thành báo cáo issue markdown sắc nét theo chuẩn GitHub. Sử dụng khi người dùng dán thông tin lỗi, thông báo lỗi hoặc mô tả không chính thức và muốn có một issue GitHub có cấu trúc. Hỗ trợ hình ảnh/GIF để làm bằng chứng trực quan.

Đo điểm chuẩn Golang, lập hồ sơ hiệu năng và đo lường hiệu suất. Sử dụng khi viết, chạy hoặc so sánh các điểm chuẩn Go, lập hồ sơ các đường dẫn nóng với pprof, diễn giải hồ sơ CPU/bộ nhớ/trace, phân tích kết quả với benchstat, thiết lập phát hiện suy giảm điểm chuẩn CI, hoặc điều tra hiệu suất sản xuất với số liệu runtime Prometheus. Cũng sử dụng khi nhà phát triển cần phân tích sâu về một chỉ số hiệu suất cụ thể - kỹ năng này cung cấp phương pháp đo lường, trong khi...

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, viper, or urfave/cli. For cobra-specific APIs → See `samber/cc-skills-golang@golang-spf13-cobra` skill; for viper configuration layering → See...

Các quy ước về phong cách code Golang — độ dài dòng và ngắt dòng, khai báo biến, rõ ràng trong luồng điều khiển, khi nào comment có ích và khi nào gây hại. Sử dụng khi viết hoặc review code Go, hỏi về phong cách hoặc sự

Các mẫu đồng thời trong Golang. Sử dụng khi viết hoặc xem xét mã Go đồng thời liên quan đến goroutine, channel, select, khóa, nguyên thủy đồng bộ, errgroup, singleflight, worker pool, hoặc pipeline fan-out/fan-in. Cũng kích hoạt khi phát hiện rò rỉ goroutine, điều kiện tranh chấp, vấn đề sở hữu channel, hoặc cần chọn giữa channel và mutex.

Cách sử dụng context.Context theo phong cách Go — truyền qua các ranh giới API, hủy bỏ, thời gian chờ và thời hạn, giá trị trong phạm vi yêu cầu, context.WithoutCancel cho công việc nền tồn tại lâu hơn yêu cầu. Áp dụng khi thiết kế truyền context qua các tầng, gỡ lỗi context bị rò rỉ hoặc chưa hết hạn, chọn giữa context.Background/TODO/WithoutCancel, hoặc lưu trữ giá trị trong context. Không dùng cho mã chỉ đơn thuần chấp nhận ctx làm tham số đầu tiên.

Cấu hình pipeline CI/CD sử dụng GitHub Actions cho các dự án Golang — kiểm thử, linting, SAST, quét bảo mật, độ phủ mã, Dependabot, Renovate, GoReleaser, tự động hóa đánh giá mã và pipeline phát hành. Sử dụng khi thiết lập hoặc cải thiện CI cho dự án Go, cấu hình workflow GitHub Actions, thêm công cụ lint hoặc quét bảo mật, tự động hóa cập nhật phụ thuộc, hoặc thêm các rào cản chất lượng.

Cấu trúc dữ liệu Golang — slice (nội bộ, tăng dung lượng, cấp phát trước, gói slices), map (nội bộ, bucket băm, gói maps), mảng, container/list/heap/ring, strings.Builder so với bytes.Buffer, tập hợp generic, con trỏ (unsafe.Pointer, weak.Pointer) và ngữ nghĩa sao chép. Sử dụng khi lựa chọn hoặc tối ưu cấu trúc dữ liệu Go, triển khai container generic, sử dụng các gói container/, con trỏ unsafe hoặc weak, hoặc thắc mắc về nội bộ slice/map.

Hướng dẫn toàn diện về truy cập cơ sở dữ liệu Go — truy vấn tham số hóa, quét struct, cột NULL, giao dịch, mức cô lập, SELECT FOR UPDATE, connection pool, xử lý hàng loạt, truyền context và công cụ migration. Sử dụng khi viết, xem xét hoặc gỡ lỗi mã Golang tương tác với PostgreSQL, MariaDB, MySQL hoặc SQLite; để kiểm thử cơ sở dữ liệu; hoặc cho các câu hỏi về database/sql, sqlx hoặc pgx. KHÔNG tạo lược đồ cơ sở dữ liệu hoặc SQL migration.

Hướng dẫn toàn diện về dependency injection (DI) trong Golang. Bao gồm lý do DI quan trọng (khả năng kiểm thử, ghép nối lỏng lẻo, phân tách mối quan tâm, quản lý vòng đời), tiêm phụ thuộc thủ công qua constructor, và so sánh thư viện DI (google/wire, uber-go/dig, uber-go/fx, samber/do). Sử dụng kỹ năng này khi thiết kế kiến trúc dịch vụ, thiết lập dependency injection, tái cấu trúc mã ghép nối chặt chẽ, quản lý singleton hoặc service factory, hoặc khi người dùng hỏi về inversion of control, service...

Các chiến lược quản lý phụ thuộc cho dự án Golang — quản lý go.mod, cài đặt/nâng cấp gói, Lựa chọn Phiên bản Tối thiểu, quét lỗ hổng bảo mật, theo dõi phụ thuộc lỗi thời, phân tích kích thước tệp nhị phân, thiết lập Dependabot/Renovate, giải quyết xung đột, và không gian làm việc go.work. Sử dụng khi thêm, xóa hoặc nâng cấp phụ thuộc Go, kiểm tra lỗ hổng bảo mật, giải quyết xung đột phiên bản, hoặc thiết lập cập nhật phụ thuộc tự động.

Các mẫu thiết kế Golang theo phong cách bản địa — tùy chọn hàm, hàm khởi tạo, luồng lỗi và xếp tầng, quản lý tài nguyên và vòng đời, tắt máy an toàn, khả năng phục hồi, kiến trúc, tiêm phụ thuộc, xử lý dữ liệu, truyền phát, v.v. Áp dụng khi lựa chọn rõ ràng giữa các mẫu kiến trúc, triển khai tùy chọn hàm, thiết kế API hàm khởi tạo, thiết lập tắt máy an toàn, áp dụng các mẫu phục hồi, hoặc hỏi mẫu Go bản địa nào phù hợp với một vấn đề cụ thể.

Hướng dẫn tài liệu toàn diện cho các dự án Golang, bao gồm chú thích godoc, README, CONTRIBUTING, CHANGELOG, Go Playground, bài kiểm tra mẫu, tài liệu API và llms.txt. Sử dụng khi viết hoặc xem xét chú thích tài liệu, tài liệu hóa, thêm ví dụ mã, thiết lập trang tài liệu hoặc thảo luận về các phương pháp hay nhất cho tài liệu. Kích hoạt cho cả thư viện và ứng dụng/CLI.

Xử lý lỗi Golang theo phong cách b

We need to translate the given text from English to Vietnamese, preserving the specified name "golang-google-wire" 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-google-wire" does not appear in the source text, so we don't include it. We must preserve product names, protocol names, URLs, numbers, and technical terms. So we keep "google/wire", "wire.NewSet", "wire.Build", "wire.Bind", "interface→concrete", "wire.Struct", "wire.Value", "wire.InterfaceValue", "wire.FieldsOf", "//go:build wireinject", "wire_gen.go", "github.com/google/wire", "wire.Build", "runtime DI", "reflection". Also preserve the ellipsis at the end. The text is a description of a skill for compile-time dependency injection in Golang using google/wire. We need to translate the surrounding Vietnamese text naturally

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`.

Cung cấp hướng dẫn sử dụng gRPC, cách tổ chức protobuf và các mẫu sẵn sàng cho production dành cho microservices Golang. Sử dụng khi triển khai, xem xét hoặc gỡ lỗi máy chủ/máy khách gRPC, viết tệp proto, thiết lập interceptor, xử lý lỗi gRPC với mã trạng thái, cấu hình TLS/mTLS, kiểm thử với bufconn hoặc làm việc với streaming RPC.

Trình điều phối kỹ năng Golang — luôn hoạt động trên mọi tác vụ lập trình, xem xét, gỡ lỗi hoặc thiết lập Golang. Đọc ngữ cảnh tác vụ và tải các kỹ năng phù hợp nhất từ samber/cc-skills-golang, thường là nhiều kỹ năng cùng lúc: viết dịch vụ gRPC tải golang-grpc + golang-testing + golang-error-handling; gỡ lỗi panic tải golang-troubleshooting + golang-safety; kiểm tra bảo mật tải golang-security + golang-lint + golang-safety. Ngoài ra: phân biệt các cụm kỹ năng cạnh tranh khi hai kỹ năng có vẻ chồng chéo...

Các phương pháp linting tốt nhất và cấu hình golangci-lint cho các dự án Golang — chạy linters, cấu hình .golangci.yml, loại bỏ cảnh báo bằng chỉ thị nolint, diễn giải đầu ra lint, và lựa chọn linters. Sử dụng khi cấu hình golangci-lint, hỏi về cảnh báo lint hoặc loại bỏ nolint, thiết lập công cụ chất lượng mã, hoặc chọn linters. Cũng sử dụng khi người dùng đề cập đến golangci-lint, go vet, staticcheck, hoặc revive.

golang-linter — một kỹ năng có thể cài đặt cho các tác nhân AI.

Hiện đại hóa mã Golang để sử dụng các tính năng ngôn ngữ mới, cải tiến thư viện chuẩn và các mẫu mã thành ngữ. Kích hoạt chủ động khi viết hoặc xem xét mã Go và phát hiện các mẫu mã kiểu cũ, hoặc khi gặp cảnh báo lỗi thời. Cũng sử dụng khi người dùng yêu cầu hiện đại hóa, nâng cấp phiên bản Go hoặc làm mới CI/công cụ.

Quy ước đặt tên trong Go (Golang) — bao gồm packages, constructors, structs, interfaces, constants, enums, errors, booleans, receivers, getters/setters, functional options, acronyms, test functions và subtest names. Sử dụng kỹ năng này khi viết mã Go mới, xem xét hoặc tái cấu trúc, lựa chọn giữa các phương án đặt tên thay thế (New vs NewTypeName, isConnected vs connected, ErrNotFound vs NotFoundError, StatusReady vs StatusUnknown tại iota 0), tranh luận về tên package Go (các phản mẫu utils/helpers), hoặc...

Golang giám sát hàng ngày — các tín hiệu luôn bật trong sản xuất. Bao gồm ghi log có cấu trúc với slog, số liệu Prometheus, theo dõi phân tán OpenTelemetry, hồ sơ liên tục với pprof/Pyroscope, theo dõi sự kiện RUM phía máy chủ, cảnh báo và bảng điều khiển Grafana. Áp dụng khi instrument các dịch vụ Go để giám sát sản xuất, thiết lập số liệu hoặc cảnh báo, thêm theo dõi OpenTelemetry, tương quan log với trace, di chuyển logger cũ (zap/logrus/zerolog) sang slog, thêm...

Các mẫu và phương pháp tối ưu hiệu năng Golang - nếu X là điểm nghẽn, thì áp dụng Y. Bao gồm giảm cấp phát, hiệu quả CPU, bố trí bộ nhớ, tinh chỉnh GC, pooling, caching, và tối ưu đường dẫn nóng. Sử dụng khi profiling hoặc benchmark đã xác định được điểm nghẽn và bạn cần mẫu tối ưu phù hợp để khắc phục. Cũng sử dụng khi thực hiện đánh giá mã hiệu năng để đề xuất cải tiến hoặc benchmark có thể giúp xác định các cải thiện hiệu năng nhanh chóng. Không dành cho phương pháp đo lường (→...

Đề xuất các thư viện và framework Golang sẵn sàng cho sản xuất. Áp dụng khi người dùng yêu cầu rõ ràng về gợi ý thư viện, muốn so sánh các lựa chọn thay thế, cần chọn thư viện cho một tác vụ cụ thể, hoặc khi một phụ thuộc mới đang được thêm vào dự án.

Cung cấp hướng dẫn thiết lập cấu trúc dự án và không gian làm việc Golang. Sử dụng khi bắt đầu một dự án Go mới, tổ chức lại mã nguồn hiện có, thiết lập monorepo với nhiều gói, tạo công cụ CLI với nhiều gói chính, quyết định giữa các quy ước thư mục cmd/internal/pkg, hoặc thảo luận về tái cấu trúc gói, tách gói, hoặc tách module.

Lập trình Golang phòng thủ để ngăn chặn panics, hỏng dữ liệu âm thầm và lỗi runtime tinh vi. Sử dụng khi gặp nil panics, bí danh append, truy cập đồng thời map, bẫy so sánh float hoặc câu hỏi về thiết kế giá trị zero. Cũng sử dụng khi xem xét mã về an toàn nil, tràn số khi chuyển đổi, vấn đề vòng đời tài nguyên (defer trong vòng lặp) hoặc sao chép phòng thủ của slice và map.

Tiêm phụ thuộc trong Golang sử dụng samber/do — container dịch vụ, quản lý vòng đời, phạm vi, kiểm tra sức khỏe, tắt máy an toàn và tổ chức module. Áp dụng khi sử dụng hoặc áp dụng samber/do, khi codebase import github.com/samber/do hoặc github.com/samber/do/v2, hoặc khi tái cấu trúc tiêm constructor thủ công vào container DI.