SuperAPI AI 工具集

api-error-handling

编程与开发

查看项目

更新于 10-16 08:04

技能介绍

用途:为 PHP REST API 建立统一、可复用的错误响应体系,覆盖错误格式化、异常信息提取与前端提示。

主要能力:所有端点使用一致的 JSON 信封;从各类异常(含数据库异常)中提取具体错误消息;为不同错误类别分配恰当的 HTTP 状态码;提供机器可读错误码与人类可读消息;生产环境不泄露堆栈信息;带请求 ID 的日志记录;与 SweetAlert2 集成,确保错误始终以弹窗展示而非静默失败。

使用方式:先阅读 SKILL.md,再按需加载 references/ 与 examples/ 中的深入内容,避免默认加载全部文件。按技能给出的有序指引、检查清单与决策规则执行,产出实现指导、评审发现、架构决策、模板或生成物,并明确假设、风险与后续工作。技能提到需配合 Vibe Security Skill 用于 PHP API 安全基线。

适用场景:构建需要一致错误格式、校验错误处理、数据库异常消息提取的 REST API;跨平台部署于 Windows(开发)、Ubuntu(预发布)、Debian(生产),MySQL 8.x,使用 utf8mb4_unicode_ci 排序规则,require 路径需严格匹配大小写并使用正斜杠。

限制:不适用于与 api-error-handling 无关的任务,或仅需简单回答的场景;示例不可直接复制,需核对适配性与失败模式。具体安装命令、价格与平台支持等资料暂未提供。