技能介绍

解决什么具体问题

直接让通用模型生成 Go 代码时，常会出现几类工程问题：

忽略 context.Context 的全链路传递，导致请求级操作无法取消或超时失效。
外部调用未设置超时，或吞掉错误、抛出缺少业务上下文的裸错误。
业务逻辑与 HTTP 框架、数据库驱动、缓存或第三方 SDK 耦合过深，后续难以替换和测试。
并发、队列、缓存等性能相关的改动缺少压测、benchmark 或 pprof 证据就上线。
配置加载、日志、指标、链路追踪、健康检查与优雅退出等生产化细节被遗漏。

技能如何工作

该技能定位为一个轻量的工程路由规则集。它不预生成大量代码，而是通过按需阅读资源文件将工程规范注入任务上下文：

按需资源路由：始终从 SKILL.md 开始，但只读取与任务匹配的文档。

- 架构重构任务读取 resources/architecture.md 与 resources/code-quality.md。
- 常规编码或 Bug 修复读取 resources/code-quality.md 与 resources/testing-ci.md。
- 性能与并发优化读取 resources/performance.md、resources/testing-ci.md 与 resources/observability.md。
- 生产部署、安全或可观测性任务按需读取 production.md、security.md、observability.md 和 checklist.md。

强制 Go 规则：内置 12 条红线，覆盖上下文传播、超时控制、错误包装、敏感信息日志脱敏、避免全局可变状态、依赖注入、消费方接口定义、以及用测试和性能证据兜底新行为。
结构化输出：实现任务必须给出任务理解、所用资源、设计决策、改动文件、所需测试、验证命令和后续风险；代码审查必须区分严重问题、修复建议、风险等级和验证命令。
闭环验证：改动代码后，在完整本地检查之外，对性能敏感的改动补充基准或分析命令；最终检查要求格式化、测试通过、使用 go test -race ./... 覆盖并发敏感代码、错误已处理并包装、日志未泄露敏感信息、公有 API 具备校验和安全控制，且生产服务包含健康检查与优雅退出。

适用边界与注意点

该技能适用于 API、后端、Worker、网关、CLI、SaaS 后端、微服务、内部工具与 Go 库的开发、审查、重构和生产化准备。但它本质上是一份规范导航与审查清单，无法替代对业务领域的理解。规则中的“外部调用超时”等表述需要结合具体客户端配置落地，模型仍可能给出不准确的命令示例，因此涉及并发、锁、事务边界与底层数据库调优时，仍需人工验证并结合基准测试判断。