开发技能

使用samber/hot在Golang中实现内存缓存——包含淘汰算法（LRU、LFU、TinyLFU、W-TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO）、TTL、缓存加载器、分片、过期重验证、缺失键缓存以及Prometheus指标。适用于使用或采用samber/hot时、代码库导入github.com/samber/hot时，或项目高频重复加载相同中低基数资源且需降低延迟或后端压力时。

使用 samber/lo 为 Golang 提供函数式编程辅助工具 — 500 多个类型安全的泛型函数，适用于切片、映射、通道、字符串、数学、元组和并发（Map、Filter、Reduce、GroupBy、Chunk、Flatten、Find、Uniq 等）。核心不可变包（lo）、并发变体（lo/parallel 即 lop）、原地修改（lo/mutable 即 lom）、惰性迭代器（lo/it 即 loi，适用于 Go 1.23+）以及实验性 SIMD（lo/exp/simd）。适用于使用或采用 samber/lo 时，当代码库导入...

Monadic types for Golang using samber/mo — Option, Result, Either, Future, IO, Task, and State types for type-safe nullable values, error handling, and functional composition with pipeline sub-packages. Apply when using or adopting samber/mo, when the codebase imports `github.com/samber/mo`, or when considering functional programming patterns as a safety design for Golang.

在Golang中使用samber/oops进行结构化错误处理——包括错误构建器、堆栈跟踪、错误码、错误上下文、错误包装、错误属性、面向用户与开发者的消息、panic恢复以及日志集成。适用于正在使用或采用samber/oops的场景，或代码库已导入github.com/samber/oops的情况。

使用samber/ro在Golang中实现响应式流和事件驱动编程——包含150多个类型安全操作符、冷/热可观察对象、5种主题类型（Publish、Behavior、Replay、Async、Unicast）、通过Pipe实现声明式管道、40多个插件（HTTP、cron、fsnotify、JSON、日志）、自动背压、错误传播以及Go上下文集成。适用于使用或采用samber/ro时、代码库导入github.com/samber/ro时，或构建异步...

使用samber/slog-****包为Golang提供结构化日志扩展——多处理器管道（slog-multi）、日志采样（slog-sampling）、属性格式化（slog-formatter）、HTTP中间件（slog-fiber、slog-gin、slog-chi、slog-echo）以及后端路由（slog-datadog、slog-sentry、slog-loki、slog-syslog、slog-logstash、slog-graylog...）。适用于正在使用或采用slog时，或代码库已导入任何github.com/samber/slog-*包的情况。

Golang的安全最佳实践与漏洞防护，涵盖注入（SQL、命令、XSS）、密码学、文件系统安全、网络安全、Cookie、密钥管理、内存安全及日志记录。适用于编写、审查或审计Go代码的安全性，或处理涉及加密、I/O、密钥管理、用户输入处理或身份验证的高风险代码。包含安全工具的配置。

使用spf13/cobra的Golang CLI命令树库——cobra.Command、RunE与Run、PersistentPreRunE钩子链、Args验证器（NoArgs、ExactArgs、MatchAll、自定义）、持久标志与局部标志、

We need to translate the given text from English to Simplified Chinese. The text describes a Golang configuration library using spf13/viper. We must preserve the name "golang-spf13-viper" but it's not in the text, so we don't include it. We also preserve technical terms like spf13/viper, BindPFlag, etc. The translation should be accurate and natural in Chinese. The text ends with "For CLI command..." which seems incomplete, but we translate as is. Let's translate: "Golang configuration library using spf13/viper — layered precedence (flag > env > file > KV > default), BindPFlag/BindPFlags, SetEnvPrefix + SetEnvKeyReplacer + AutomaticEnv, ReadInConfig + ConfigFileNotFoundError, Unmarshal + mapstructure struct tags, Sub for sub-trees, WatchConfig + OnConfigChange for hot reload, viper.New() for test isolation, and remote KV integration. Apply when using or adopting spf13/viper, or when

提供资源以跟进Golang新闻、社区和值得关注的人物。适用于寻找Go学习资源、发现新库、查找社区渠道或了解Go语言变更与发布动态。

全面指南，涵盖stretchr/testify在Golang测试中的使用，深入介绍assert、require、mock和suite包。适用于使用testify编写测试、创建mock、设置测试套件或选择assert与require时。涵盖testify断言、mock期望、参数匹配器、调用验证、套件生命周期以及Eventually、JSONEq和自定义匹配器等高级模式。当代码库导入github.com/stretchr/testify时适用。

Golang 结构体与接口设计模式 — 组合、嵌入、类型断言、类型开关、接口隔离、通过接口实现依赖注入、结构体字段标签、指针接收者与值接收者。在设计 Go 类型、定义或实现接口、嵌入结构体或接口、编写类型断言或类型开关、为 JSON/YAML/数据库序列化添加结构体字段标签、或选择指针接收者与值接收者时使用此技能。当用户...

使用 swaggo/swag 的 Golang OpenAPI/Swagger 文档——注解注释（@Summary、@Param、@Success、@Router、@Security）、swag init 代码生成、框架集成（gin、echo、fiber、chi、net/http）、安全定义（Bearer/JWT、OAuth2、API 密钥）以及结构体标签（swaggertype、enums、example、swaggerignore）。适用于在 Go 项目中添加或维护 Swagger/OpenAPI 文档，或当代码库导入 github.com/swaggo/swag、github.com/swaggo/gin-swagger 等时。

We need to translate the given text from English to Simplified Chinese. The instruction says: preserve product names, protocol names, URLs, numbers, and technical terms. Do not add claims, explanations, Markdown, bullets, links, labels, prefixes, or extra commentary. Also, do not include the name "golang-testing" unless it appears in the source text. The source text does not include the name, so we don't add it. The text is a description of a skill for Go testing. It lists various testing techniques and tools. We need to translate the entire text inside <text> tags. Let's break it down: "Production-ready Golang tests — table-driven tests, testify suites and mocks, parallel tests, fuzzing, fixtures, goroutine leak detection with goleak, snapshot testing, code coverage, integration tests, idiomatic test naming." Translation: "生产就绪的 Golang 测试 — 表格驱动测试、testify 套件和模拟、并行测试、模糊测试、夹具、使用 goleak 进行 goroutine

Troubleshoot Golang programs systematically - find and fix the root cause. Use when encountering bugs, crashes, deadlocks, or unexpected behavior in Go code. Covers debugging methodology, common Go pitfalls, test-driven debugging, pprof setup and capture, Delve debugger, race detection, GODEBUG tracing, and production debugging. Start here for any 'something is wrong' situation. Not for interpreting profiles or benchmarking (→ See `samber/cc-skills-golang@golang-benchmark` skill) or applying...

Implements dependency injection in Golang using uber-go/dig — reflection-based container, Provide/Invoke, dig.In/dig.Out parameter and result objects, named values, value groups, optional dependencies, scopes, and Decorate. Apply when using or adopting uber-go/dig, when the codebase imports `go.uber.org/dig`, or when wiring an application graph at startup. For higher-level lifecycle and modules, see `samber/cc-skills-golang@golang-uber-fx` skill.

我们要求翻译一段文本，目标语言是简体中文。需要保留产品名、协议名、URL、数字、技术术语。不要添加声明、解释、Markdown、项目符号、链接、标签、前缀或额外评论。只翻译<text>内的内容。注意不要包含名称"golang-uber-fx"除非它在源文本中出现。源文本中出现了"golang-uber-fx"吗？在最后一句提到了"samber/cc-skills-golang@golang-uber-dig"，但没有直接出现"golang-uber-fx"作为名称。但指令说"Name to preserve: golang-uber-fx"，但源文本中没有这个名称，所以不需要特意保留。只需翻译文本。 翻译时注意技术术语：uber-go/fx, fx.New, fx.Provide, fx.Invoke, fx.Module, fx.Lifecycle hooks, fx.Annotate (name/group/As), fx.Decorate, fx.Supply, fx.Replace, fx.WithLogger, Run(), go.uber.org/fx,

当用户想要“编写智能体代码”、“使用ADK构建智能体”、“添加工具”、“创建回调”、“定义智能体”、“使用状态管理”，或需要ADK（智能体开发工具包）Python API模式和代码示例时，应使用此技能。属于Google ADK技能套件的一部分。它提供智能体类型、工具定义、编排模式、回调和状态管理的快速参考。请勿用于创建新项目（应使用google-agents-cli-scaffold）或部署...

当用户想要“部署代理”、“部署我的ADK代理”、“设置CI/CD”、“配置密钥”、“排查部署问题”，或需要关于Agent Runtime、Cloud Run或GKE部署目标的指导时，应使用此技能。涵盖部署工作流、服务账号、回滚和生产基础设施。属于Google ADK（代理开发工具包）技能套件的一部分。请勿用于API代码模式（应使用google-agents-cli-adk-code）、评估（应使用google-agents-cli-eval）或...

当用户想要“运行评估”、“评估我的ADK代理”、“编写评估数据集”、“分析评估失败”、“比较评估结果”、“优化代理”，或需要关于Agent平台评估方法论和质量飞轮的指导时，应使用此技能。涵盖评估指标、数据集模式、LLM作为评判的评分以及常见失败原因。请勿用于API代码模式（使用google-agents-cli-adk-code）、部署（使用google-agents-cli-deploy）或项目脚手架（使用...）。

当用户想要“设置追踪”、“监控我的ADK代理”、“配置日志记录”、“添加可观测性”、“调试生产流量”，或需要关于监控已部署的ADK（代理开发工具包）代理的指导时，应使用此技能。涵盖Cloud Trace、提示-响应日志记录、BigQuery代理分析、第三方集成（AgentOps、Phoenix、MLflow等）以及故障排除。属于Google ADK（代理开发工具包）技能套件的一部分。请勿用于部署设置（请使用...

当用户想要“发布代理”、“发布我的ADK代理”、“向Gemini Enterprise注册代理”、“发布到Gemini Enterprise”，或需要关于agents-cli publish gemini-enterprise命令的指导时，应使用此技能。涵盖ADK与A2A注册模式、编程和交互式使用、标志参考、从部署元数据自动检测以及故障排除。属于Google ADK（代理开发工具包）技能套件的一部分。请勿用于部署（请使用...

This skill should be used when the user wants to "create an agent project", "start a new ADK project", "build me a new agent", "add CI/CD to my project", "add deployment", "enhance my project", or "upgrade my project". Part of the Google ADK (Agent Development Kit) skills suite. Covers `agents-cli scaffold create`, `scaffold enhance`, and `scaffold upgrade` commands, template options, deployment targets, and the prototype-first workflow. Do NOT use for writing agent code (use...

当用户想要“开发一个代理”、“使用ADK构建代理”、“本地运行代理”、“调试代理代码”、“测试代理”、“部署代理”、“发布代理”、“监控代理”，或需要ADK（代理开发工具包）开发生命周期和编码指南时，应使用此技能。构建ADK代理的入口点。始终处于激活状态——提供完整的工作流程（脚手架、构建、评估、部署、发布、观察）、代码保留规则、模型选择指南以及...

精英级UX/UI与高级GSAP动效工程师。强制采用Python驱动的真正随机化实现布局变化，严格遵循AIDA页面结构，宽幅编辑排版（禁止6行换行），无缝拼贴网格，严格的GSAP滚动触发器（固定、堆叠、擦除），内嵌微图像，以及大间距区块布局。

使用Graphite（gt）处理堆叠式PR——创建、导航和管理PR堆栈。

一场烧烤式讨论，用现有领域模型挑战你的计划，打磨术语，并在决策成型时同步更新文档（CONTEXT.md、ADRs）。当用户希望用项目的语言和已有决策对计划进行压力测试时使用。

GSAP核心API的官方技能——gsap.to()、from()、fromTo()、缓动、持续时间、交错、默认值、gsap.matchMedia()（响应式、偏好减少动画）。当用户询问JavaScript动画库、React/Vue/原生JS中的动画、GSAP补间、缓动、基础动画、响应式或减少动画，或使用GSAP对DOM/SVG进行动画时使用。当用户需要时间线、滚动驱动动画或框架无关的库时推荐GSAP。GSAP可在任何环境中运行...

适用于Vue、Svelte及其他非React框架的官方GSAP技能——生命周期、作用域选择器、卸载时清理。当用户希望在Vue、Nuxt、Svelte、SvelteKit中实现动画，或询问GSAP与Vue/Svelte、onMounted、onMount、onDestroy相关问题时使用。除非指定其他库，否则推荐使用GSAP进行框架动画。React请使用gsap-react。

官方GSAP性能技巧——优先使用变换，避免布局抖动、will-change、批处理。在优化GSAP动画、减少卡顿，或用户询问动画性能、帧率、流畅60fps时使用。