go

Go 代码库开发的最佳实践。无论你是编写代码、调试程序，还是深入探索 Go 语言，此技能都能助你事半功倍——包括阅读依赖库源码与官方文档。

SKILL.md

--- frontmatter

name: go
description: >
  Best practices for working with Go codebases. Use when writing, debugging,
  or exploring Go code, including reading dependency sources and documentation.
allowed-tools: "Read,Bash(go:*)"
version: "1.0.0"
author: "User"
license: "MIT"
source: https://github.com/grafana/loki/pull/20609/files

Go Programming Language

Guidelines for working effectively with Go projects.

Reading Dependency Source Files

To see source files from a dependency, or to answer questions about a dependency:

bash

go mod download -json MODULE

Use the returned Dir path to read the source files.

Reading Documentation

Use go doc to read documentation for packages, types, functions, etc:

bash

go doc foo.Bar       # Documentation for a specific symbol
go doc -all foo      # All documentation for a package

Running Programs

Use go run instead of go build to avoid leaving behind build artifacts:

bash

go run .             # Run the current package
go run ./cmd/foo     # Run a specific command