leikegeek/frontend-api-contract-check
skills/frontend-common/api-contract-check/SKILL.md
前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
$ install --global
skillsauthnpx skillsauth add leikegeek/coding-exoskeleton frontend-api-contract-checkInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 4, 2026, 2:45 AM60.2s1 file scanned
SKILL.md
- name:
- frontend-api-contract-check
- displayName:
- 前端 API 契约核对
- description:
- 前端接入接口、修复提交失败、核对列表/详情/保存字段、处理类型漂移或空值风险时使用。输出契约不一致点、收敛方案和回归建议。
- triggers:
- ["接口契约", "字段映射", "提交失败", "回填异常", "API对齐", "类型不一致"]
- autoTrigger:
- true
- version:
- 1.0.0
前端 API 契约核对
前置检查
- 读取
AGENTS.md，确认techStack为frontend-vue3或frontend-react-umi。 - 若不是前端 profile，跳过本 skill，回退到通用
coding/testing。 - 优先读取项目已有接口文档、生成代码说明、
docs/*api*或变更记录。
核对流程
- 找到 API/service 定义、调用页面、表单模型、展示模型和类型定义。
- 对比列表、详情、提交、导入导出等相关接口是否混用字段。
- 标记字段缺失、命名漂移、可空风险、重复转换和错误处理差异。
- 给出收敛方案：集中映射、补类型、统一默认值、调整请求 helper 或回退到 codegen。
- 输出验证路径，覆盖成功、失败、空数据和慢返回。
必查项
- 请求参数是否与后端约定一致。
- 响应结构是否被错误解包或过度断言。
- 前端展示字段与提交字段是否混在同一个对象里。
- 多组件是否重复维护同一套字段转换。
- 文件上传、下载、批量操作是否保留统一请求栈能力。
输出格式
- 现状与接口范围
- 契约不一致点
- 根因判断
- 收敛方案
- 涉及文件
- 回归建议
Related Skills
leikegeek/audit-context-intake
development
VerifiedTrustedCommunity
将本地 /code 流程产物、Git 可获取变更或 GitLab Merge Request 链接归一化为统一 AuditContext，供 audit-reviewer 执行业务、质量、安全一体化审计。
3SKILL.mdUpdated Jun 4, 2026
leikegeek/vue3-dialog-form-workflow
tools
VerifiedTrustedCommunity
在 Vue 3 项目中新增或改造弹窗、表单、导入流程、编辑回填、保存提交和关闭刷新链路时使用。强调独立 Dialog、本地表单状态和封装组件优先。
3SKILL.mdUpdated Jun 4, 2026
leikegeek/vue3-component-delivery
development
VerifiedTrustedCommunity
在 Vue 3 + TypeScript 项目中新增或修改 SFC、组合式逻辑、Element Plus/Sh* 包装组件、表格和页面组件时使用。强调 Composition API、组件契约和最小改动。
3SKILL.mdUpdated Jun 4, 2026
leikegeek/vue3-api-codegen
development
VerifiedTrustedCommunity
在 Vue 3 项目中接入 swagger/codegen 生成 API、核对生成目录、临时补充接口或替换页面内请求时使用。强调不手改生成物和契约收敛。
3SKILL.mdUpdated Jun 4, 2026