Agent Skills
返回列表
💻

蚂蚁社保Spring接口契约审查

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @mayishebao/mayishebao-1221-0221

技能介绍

要解决的具体问题

在 Java 后端与微服务开发中,Spring 接口契约变更常引发兼容性故障:字段类型调整导致序列化异常、参数校验规则改动引发前端调用失败、版本升级后接口行为不一致影响业务连续性。本技能聚焦中国职场场景下的接口契约审查,解决以下核心问题:

  • 接口变更影响范围不清晰,缺乏可追溯的测试证据链
  • 发布与回滚流程未标准化,线上故障恢复滞后
  • 跨团队协作时技术约束传递不到位,验收标准模糊

技能如何工作

该技能通过五步可验证流程完成审查,确保结论可追溯、动作可执行:

  1. 复述目标与验收条件:从业务目标、代码仓库、技术栈版本等输入中提取审查边界,避免信息缺失导致的误判
  2. 复现与范围缩小:基于最小复现环境定位接口行为差异,优先通过日志与报错分析问题根因
  3. 最小可逆变更设计:提出接口兼容性方案,同步生成备选方案对比表,明确变更影响评估维度
  4. 测试覆盖补齐:补充单元测试断言接口契约,集成测试验证跨服务调用,性能测试量化响应时间变化
  5. 发布与监控规范:制定分阶段发布计划,配置监控指标与告警阈值,输出回滚触发条件与操作手册

输出格式严格遵循 问题定位 → 证据 → 方案比较 → 变更清单 → 测试用例 → 发布与回滚步骤 → 遗留风险 的结构,确保技术决策可复盘。

适用边界与注意点

  • 仅适用于中国职场的 Spring 后端项目,涉及社保公积金等场景时需触发合规提示,不替代专业法律复核
  • 依赖输入材料的完整性,信息不足时保留 待补充 占位符,禁止虚构运行日志或测试结果
  • 敏感数据处理遵循脱敏原则,示例数据默认屏蔽密码、令牌、身份证号等字段
  • 不处理涉及法律、税务、财务的实质性建议,仅提供技术层面的契约审查支持

使用场景

  • 微服务接口上线前需调整字段类型,审查`/order/detail`返回结构兼容性并补测试。
  • 处理生产环境`NullPointerException`报错,从代码日志定位接口契约并缩小复现范围。
  • 数据库字段从`String`改为`LocalDate`后,审查序列化策略避免前端解析异常。
  • 准备灰度发布时需评估接口变更影响,补齐集成与性能测试并制定回滚方案。

适合人员

  • 负责Spring接口维护的后端工程师,需确保字段变更与版本兼容,减少上线风险。
  • 执行接口联调与验收的技术负责人,需要可验证的测试证据链与发布回滚方案。
  • 持续接收接口异常告警的运维人员,需要基于日志定位契约问题并恢复服务。
  • 处理中国合规用工场景的数据工程师,需在接口审查中触发社保衔接提醒。