메뉴
在新增项目通用工具函数前，从 github.com/samber/lo 和 github.com/duke-git/lancet/v2 中查找并选择可复用的 Go 工具函数。实现或审查跨模块工具、集合映射字符串时间文件处理、指针默认值转换、重试或并发辅助逻辑时使用，尤其适用于在 utils/ 下新增代码之前。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
指导 Go 后端功能的分层设计、领域实体建模、Service 编排、错误边界、日志与依赖方向。新增或修改 application、model/entity、infrastructure、transport、controller、repository 或 Service 代码时使用。
Comprehensive documentation guide for Golang projects, covering godoc comments, README, CONTRIBUTING, CHANGELOG, Go Playground, Example tests, API docs, and llms.txt. Use when writing or reviewing doc comments, documentation, adding code examples, setting up doc sites, or discussing documentation best practices. Triggers for both libraries and applications/CLIs.
Golang benchmarking, profiling, and performance measurement. Use when writing, running, or comparing Go benchmarks, profiling hot paths with pprof, interpreting CPU/memory/trace profiles, analyzing results with benchstat, setting up CI benchmark regression detection, or investigating production performance with Prometheus runtime metrics. Also use when the developer needs deep analysis on a specific performance indicator - this skill provides the measurement methodology, while golang-performance provides the optimization patterns.
Golang code style, formatting and conventions. Use when writing Go code, reviewing style, configuring linters, writing comments, or establishing project standards.
Golang concurrency patterns. Use when writing or reviewing concurrent Go code involving goroutines, channels, select, locks, sync primitives, errgroup, singleflight, worker pools, or fan-out/fan-in pipelines. Also triggers when you detect goroutine leaks, race conditions, channel ownership issues, or need to choose between channels and mutexes.
Provides CI/CD pipeline configuration using GitHub Actions for Golang projects. Covers testing, linting, SAST, security scanning, code coverage, Dependabot, Renovate, GoReleaser, code review automation, and release pipelines. Use this whenever setting up CI for a Go project, configuring workflows, adding linters or security scanners, setting up Dependabot or Renovate, automating releases, or improving an existing CI pipeline. Also use when the user wants to add quality gates to their Go project.
| name | go-utility-libraries |
| description | 在新增项目通用工具函数前，从 github.com/samber/lo 和 github.com/duke-git/lancet/v2 中查找并选择可复用的 Go 工具函数。实现或审查跨模块工具、集合映射字符串时间文件处理、指针默认值转换、重试或并发辅助逻辑时使用，尤其适用于在 utils/ 下新增代码之前。 |
新增项目级辅助函数前使用本技能。标准库能够清晰表达意图时优先使用标准库；否则在 lo 或 Lancet 中选择现成实现，再考虑在 utils/ 下新增代码。
github.com/samber/lo v1.53.0 是直接依赖。github.com/duke-git/lancet/v2 v2.3.9 已作为间接依赖存在。github.com/duke-git/lancet/v2/strutil。选择函数时读取函数索引。该索引用于按类别定位候选函数，不能替代锁定版本中对精确签名与行为的说明。
明确输入、输出、错误行为、是否修改输入，以及是否需要取消能力。
先检查标准库：slices、maps、cmp、strings、strconv、time、net/url、os 和 path/filepath 适合小而惯用的操作。
对泛型切片或映射转换、指针或默认值、分组、筛选、集合运算及小型控制流辅助，检查 lo。
对字符串、日期时间、文件、网络、类型转换、校验、重试或数据结构等广义工具，检查对应 Lancet 子包。
编码前按锁定版本核对精确 API：
go doc github.com/samber/lo
go doc github.com/duke-git/lancet/v2/<subpackage>
引入库并直接调用，前提是它能让调用点更清晰。不要仅为转调现有函数而在 utils/ 中增加包装层。
仅当标准库和这两个库都不能满足项目要求时，才在 utils/<purpose>.go 中增加聚焦的辅助函数，并编写同包测试。
| 需求 | 优先选择 | 原因 |
|---|---|---|
| 切片或映射的筛选、映射、分组、归约、指针处理 | lo | 单包内提供简洁的泛型 API。 |
| 字符串、日期时间、文件、网络、校验、加密、系统工具 | Lancet 子包 | 提供更广泛的领域型 API。 |
| 简单的标准操作 | 标准库 | 依赖更少，行为更熟悉。 |
| 领域策略或项目集成 | utils/ | 仅保留不能安全复用的代码。 |
context.Context；不要使用会丢失取消信号或引入无界后台工作的辅助函数。lo.Must 等会 panic 的辅助函数。go doc、模块缓存或锁定版本的包文档。选择辅助函数时，说明所选包和函数、它比新增 utils 辅助函数更合适的原因，以及调用方必须了解的行为。若没有可复用实现，新增项目工具前说明已检查的候选项。