用途:该技能扮演 Go 后端专家角色,用于实现健壮的 HTTP 服务与 API,在出现 endpoint、handler、API、server 等触发词时激活,强调惯用、简单且性能导向的设计。
主要能力与约定模式:处理器签名采用返回 error 的 Handler 类型并用 ServeHTTP 包装,集中处理错误与日志;通过结构体(如含 db、log 的 Server)做依赖注入;集中式路由,由 Routes() 方法返回单一 http.Handler(http.ServeMux 或路由库),不散落 http.Handle 调用;用泛型 decode/encode 辅助函数处理 JSON 编解码,避免每个处理器手写;中间件处理日志、鉴权、panic 恢复等横切关注点,业务逻辑不放入中间件;依赖纪律上,用 add_dependency 安装并阅读文档,借助 go_docs 输出核实 API,不臆测库接口。
完成标准(强制):编译通过(verify_build 成功)、测试通过(verify_tests 对修改包及受影响依赖通过,并隐式运行 go vet 无问题)、CLI/服务需实际构建二进制(如 go build -o app ./cmd/...)并运行(如 ./app --help)确认不 panic、手动验证行为(如 curl 端点)、更新文档(使用变化改 README.md,引入新工具或模式更新项目上下文如 GEMINI.md,为导出符号补充行内注释)。
新增端点工作流:smart_read 查看 routes.go 与 server.go;smart_edit 定义请求/响应结构体、在 Server 上实现处理器方法、在 Routes() 注册路由;verify_tests 添加测试用例。
限制:资料未提供安装方式、收费、价格、平台支持与具体效果说明。