Encore Go 类型安全 API

原名：encore-go-api

使用 Encore Go 注解和结构体定义类型安全 API。

中文 Skills 技能说明

适合 Go 后端接口；先明确参数、响应、认证、错误和兼容性，再实现并运行 Go 测试。Encore 开源框架和本地开发流程可在自有环境使用；使用 Encore Cloud 或外部服务时须确认账户、网络、区域、费用和数据跨境要求。执行前读取真实项目、版本和官方资料，输出目标、依据、影响、验证结果与回退方式；没有证据时明确说明未知，不编造数据、配置或成功状态。创建、修改、部署、发布、迁移、发送、删除或产生费用的操作，必须先展示目标和差异并获得有权限人员确认。代码、数据库、日志、凭据、邮件、客户和企业资料按敏感内容处理，只读取任务所需范围，上传或外发前完成授权、脱敏和最小化。

上游能力依据

上游原始适用说明：Define typed API endpoints in Encore Go using //encore:api annotations. Covers typed request/response structs, path/query/header/cookie params, and error returns. For raw endpoints (//encore:api raw) and inbound webhooks, use encore-go-webhook instead.

上游 SKILL.md 主要章节（保留原文标题）：

Instructions
1. Basic API Endpoint
2. POST with Request Body
API Annotation Options
Examples
Sensitive Data
Custom HTTP Status Codes
Request Parameter Sources
Path Parameters
Query Parameters

使用边界

先读取项目约定、依赖版本和现有测试，再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。

作者、翻译与许可证

原作者: Encore 与 encoredev/skills contributors
中文翻译: CEOFans翻译
许可证: Apache-2.0
上游来源: https://github.com/encoredev/skills/tree/741d95a38b442db47ddc4cb08042eb504967405b/encore/go-api

适用范围

平台：linux、macos、windows；标签：软件开发、Encore Go 类型安全 API

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。