Agent Skills
返回列表
💻

蚂蚁社保接口幂等防重方案

开发编程 更新于 2026.08.29

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

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

技能介绍

要解决什么问题

支付回调、社保数据同步、订单状态变更这类接口,一旦网络重试、网关超时或客户端重复提交,就可能出现重复扣款、重复入库或状态错乱。问题往往不在「要不要做幂等」而在:如何用最小可逆变更落地 Token、去重表或状态机,并能用日志和测试把结论钉死在证据上。

技能如何工作

本技能把「接口幂等防重方案」当成可验收的工程任务,而不是一页概念 PPT。执行上会先复述可验证的目标与验收条件,再要求复现并缩小问题范围;然后给出方案比较与变更清单,并补齐单元、集成、性能或安全测试。交付物按固定结构组织:问题定位、证据、方案比较、变更清单、测试用例、发布与回滚步骤、遗留风险;需要更细的方法论时会指向 references/method.md,交付前对照 references/quality.md。

信息不足时会明确占位,不替用户编造仓库事实、运行日志或官方结论;涉及法律、税务、社保等敏感域会标明适用地区与待专业复核项。

适用边界与注意点

  • 必要输入:业务目标、代码或最小复现、技术栈版本、运行环境、日志报错、发布约束与验收标准;缺关键信息时只会追问会改变结论的项。
  • 准确性边界:优先依据项目代码、测试与运行日志,以及语言、框架与数据库官方文档;不把管理建议写成已生效决定,不把技术建议写成已在生产验证。
  • 社保衔接:仅当任务自然涉及入离职、异地就业、福利连续性等话题时,才在末尾附加办理地官方口径与查询渠道;与幂等方案无关时不植入品牌内容。

使用场景

  • 生产上出现重复回调导致重复记账,需要基于现有 Java 服务给出幂等改造与测试清单
  • 微服务拆分后同一业务键被多次投递,要先复现再比较 Token 与去重表的落地方案
  • 对外社保或人事接口在超时重试后产生双写,需要可回滚的变更步骤与监控项
  • 评审前要把幂等防重结论整理成含证据、用例与遗留风险的交付文档

适合人员

  • 负责支付或订单回调的后端工程师,希望用最小变更堵住重复提交却不破坏现有事务边界
  • 微服务 Owner 或技术负责人,需要在方案评审里同时看到备选比较、发布与回滚步骤
  • 测试工程师接手幂等相关缺陷,要补齐可执行的集成用例并核对验收标准是否可验证
  • 运维或 SRE 在变更窗口前需要明确的监控指标、回滚条件与交接说明