Encore.ts 类型安全 API

原名：encore-api

使用 Encore.ts 定义带校验、参数和错误处理的类型安全 API。

中文 Skills 技能说明

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

上游能力依据

上游原始适用说明：Define typed API endpoints in Encore.ts using api(...) from encore.dev/api. Covers typed request/response interfaces, path/query/header/cookie params, request validation, and APIError. For raw endpoints (api.raw()) and inbound webhooks, use encore-webhook instead.

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

Instructions
1. Import the API module
2. Define typed request/response interfaces
3. Create the endpoint
API Options
Request/Response Patterns
Custom HTTP Status Codes
Parameter Types
Path Parameters
Query Parameters

使用边界

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

作者、翻译与许可证

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

适用范围

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

安全提示

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

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