Agent Skills
返回列表
💻

Go Lint 工程实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-lint。

技能介绍

问题背景

很多 Go 项目在合并前才临时跑 lint,输出一堆 errcheck、revive、gosec 混在一起,没人知道该先修哪一类;遗留库里一次性全开 linter 会直接淹没在几千条 issue 里。//nolint 写得不规范还会被 nolintlint 再报一轮。团队真正缺的不是「装个工具」,而是把 golangci-lint 当成一等公民:有统一的 .golangci.yml 真源、有固定开发节奏、有读懂输出和压制的规则,以及在老代码上分路并行收拾的办法。

技能如何工作

技能把你定位成 Go 代码质量工程师,按三种模式行事:

  • Setup:按顺序完成 .golangci.yml、选型 linter、接入 CI(可与 samber 系列的 CI 技能交叉对照)。
  • Coding:写新功能时,对改动文件在后台跑 golangci-lint run --fix,主流程继续实现,结果回来再收敛。
  • Interpret/fix:从「Interpreting Output」「Suppressing Lint Warnings」入手;大规模遗留清理时,按 SKILL 里的五路子任务扇出并行(auto-fix、安全类、错误处理、风格格式、代码质量),在 Claude Code 上可用 ultracode 显式多代理编排。

内容上强调:推荐生产向配置(数十个 linter)、nolint 必须带 linter 名与理由、安全类 linter 原则上不禁用;工作流包含每次大改后 run ./...、--fix、提交前 fmt,以及用 issues.new-from-rev 只 lint 增量再逐步还债。附带常见故障表(超时、legacy 爆炸、linter 缺失、配置迁移、大仓变慢等)及 verbose 解读 issue 格式 (linter-name)。

适用边界与注意点

  • 依赖本机已安装 golangci-lint(go install 路径在 SKILL 中有说明);技能不负责替代官方 linter 文档的全部细节,深度查表走 linter reference。
  • 不要用空 //nolint;安全相关(gosec、bodyclose、sqlclosecheck)无充分理由不要压制。
  • SAST、govulncheck、代码风格细则等见交叉引用的 golang-security、golang-code-style、golang-continuous-integration 技能,本技能聚焦 lint 配置、输出与修复编排。

使用场景

  • 新服务要落地第一份生产级 `.golangci.yml`,需从 30+ linter 里选型并写清启用理由
  • MR 里 `golangci-lint` 报 `(errcheck)` 与 `(wrapcheck)` 混杂,要按 linter 名分批修或写合规 nolint
  • 十年老 monorepo 首次接 lint,要用 `issues.new-from-rev` 只卡增量并五路并行清债
  • 本地频繁报 `deadline exceeded`,要在不改业务逻辑前提下调 `run.timeout` 与并发/排除路径

适合人员

  • 负责 Go 服务仓库质量门的后端工程师,要把 lint 固定进每次改动的自检流程
  • 维护公司内部 Go 模板与 CI 模板的平台同学,要统一 `.golangci.yml` 与 GitHub Actions 检查项
  • 接手遗留 Go 代码库的技术负责人,要在不冻结功能开发的前提下分批消除 lint 积压
  • 写 Claude Code / 多代理工作流的工程师,想用后台 `--fix` 与五路子任务并行扫库