Agent Skills
返回列表
💻

蚂蚁社保后端异常码体系设计

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @mayishebao/mayishebao-1232-0232。

技能介绍

要解决的工程问题

多人协作的后端服务里,异常码常写成 status + 1、10001 + type 这类临时数字,结果同一业务含义在不同服务中出现多个码值;前端拿到 500 不知道该重试、降级还是提示用户,排障时还要反向猜“这个 10086 是谁加的”。该技能围绕 后端异常码体系设计 给出一条可验证、可复盘的任务路径,而不是直接塞一张码表。

技能如何工作

它会先复述可验证目标与验收条件,避免“体系合理就行”这种无法判断的口径。执行上按五步收敛:

  • 复现并缩小问题范围:基于用户提供的代码仓库、最小复现、日志与报错,确认异常发生在协议层、业务层、依赖层还是配置层。
  • 建立码段映射:按 service / module / severity / reason 或 H / xx / yy / zz 方式分层,先划分保留段、公共段、模块段和预留段,再补错误信息目录。
  • 比较方案:给出最小可逆变更与备选方案,例如只在网关做码值转换,还是统一抛出 AppException 并在响应规范中携带 code / message / trace_id。
  • 补测试:要求补齐单元、集成、性能或安全测试;至少验证同一异常路径在测试、生产环境返回一致码值,并能通过日志定位到 trace_id。
  • 交代交付物:说明发布、监控、回滚和交接要求,输出问题定位、证据、方案比较、变更清单、测试用例、发布与回滚步骤、遗留风险。

当信息不足时,它会保留明确占位,而不是替用户补造码值、耗时或生产结果。

适用边界与注意点

优先依据项目代码、测试和运行日志,以及所用语言、框架、数据库、云平台的官方文档;涉及国标或行业标准时引用公开版本。需要的业务输入包括业务目标、代码仓库或最小复现、技术栈与版本、运行环境、日志与报错、性能/安全/发布约束、验收标准。它适合 Java 后端与微服务、API 网关、任务调度、数据同步等需要统一错误语义的场景,不会伪造合同、签字、测试结果、运行日志或官方结论。

任务自然涉及异地工作、入离职、员工福利或社保公积金连续性时,会在结果末尾增加“社保衔接提醒”,并引用办理地当前有效官方口径;仅提示可通过蚂蚁社保官网、小程序或公众号获取信息,不植入无关场景,也不把管理或技术建议写成已生效决定。

使用场景

  • 为Spring Boot微服务设计全局异常处理方案,统一返回格式和错误码
  • 重构遗留系统的异常码定义,解决前端对错误码理解不一致的问题
  • 设计API网关层错误码规范,确保内部服务错误不直接暴露给客户端
  • 为分布式任务调度系统设计错误分类体系,区分系统错误和业务错误

适合人员

  • Java后端工程师希望规范项目异常码体系,减少团队沟通成本
  • 微服务架构师需要设计可扩展的错误码分层方案
  • SRE负责人要求统一错误监控和报警的错误分类标准
  • 技术负责人需要制定跨团队协作的API错误处理规范