用途:在声明任何依赖 API 的功能“完成”之前,强制对真实后端端点做完整验证,防止只在手工测试时才暴露的前后端不匹配问题。适用于合并含 API 调用、DTO 或新后端端点的功能,以及前端对接既有后端 API 的场景;不适用于纯 UI 功能或仅 mock API 响应的单元测试。
主要能力:提供一套完成前检查清单,包括后端端点是否存在、HTTP 方法是否支持、响应结构是否符合 ApiEnvelope、字段名是否与 DTO 的 @Json 注解一致、分页结构是否匹配、错误场景(401/400/404/500)是否可被 safeApiCall() 提取,以及真机/模拟器集成测试。还列出常见前后端不匹配类型:字段大小写、语义命名、端点缺失、分页结构差异、可空性不一致。
使用方式:先读 SKILL.md,再按需加载引用文件;按顺序执行检查清单,而非挑选片段。用 curl 或 Postman 测试真实端点,例如:curl -H "Authorization: Bearer <actual_jwt_token>" "https://10.0.2.2/birdc_erp/public/api/sales-agent-portal.php?action=sales_by_product&page=1&per_page=20"。检查后端端点可用 grep -n "sales_by_product" 等命令;查看 Android DTO 字段名;用 adb logcat | grep -i "json|moshi|retrofit|http" 排查解析错误。
适用场景:新 DTO 或 API 服务实现后、新建后端端点后、提交推送 API 相关功能前、前端集成既有后端 API 时。
限制:不适用于纯 UI 功能或 mock 响应的单元测试;平台辅助插件可选,非必需;具体项目路径、令牌与端点需按实际环境替换。资料未提供收费、价格与平台支持信息。