القائمة
在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
将后端技术方案拆解为接口、应用服务、领域/业务逻辑、数据访问、消息/定时任务、迁移脚本和测试任务时使用。用于补充通用 implementation-planning 的后端归组口径。
分析后端接口、数据库访问、RPC/HTTP 调用、批处理、消息消费、事务和缓存相关性能风险时使用。强调证据、数据规模、低风险优化和回滚方案。
前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
排查并修复前端渲染、状态、表单、表格、路由、API 映射、异步时序和性能回归问题时使用。要求可复现、可定位、可验证、最小修复。
在既有前端项目中新增或扩展页面、表单、列表、弹窗、批量操作、导入导出和权限交互时使用。强调先理解调用链、复用现有结构、最小改动落地。
维护前端项目 AI 上下文文档、模块映射、API 契约、已知问题、性能基线、生成代码修正记录和变更日志时使用。用于减少重复摸索和重复返工。
| name | backend-api-contract |
| displayName | 后端 API 契约设计 |
| description | 在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。 |
| triggers | ["后端接口","API契约","DTO","错误码","幂等","分页接口","批量接口"] |
| autoTrigger | true |
| version | 1.0.0 |
AGENTS.md，确认 techStack 属于后端 profile（当前内置：cola-java）。tech-design 或对应前端 skill。