leikegeek/backend-api-contract
skills/backend-common/backend-api-contract/SKILL.md
在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
$ install --global
skillsauthnpx skillsauth add leikegeek/coding-exoskeleton backend-api-contractInstall 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:46 AM109.4s1 file scanned
SKILL.md
- name:
- backend-api-contract
- displayName:
- 后端 API 契约设计
- description:
- 在后端项目中设计或修改接口、DTO、错误码、鉴权、幂等、分页、批量操作和前后端联调契约时使用。适用于后端 profile，输出清晰的接口边界、兼容风险和验证路径。
- triggers:
- ["后端接口", "API契约", "DTO", "错误码", "幂等", "分页接口", "批量接口"]
- autoTrigger:
- true
- version:
- 1.0.0
后端 API 契约设计
前置检查
- 读取
AGENTS.md，确认techStack属于后端 profile（当前内置：cola-java）。 - 不匹配时跳过本 skill，回退到
tech-design或对应前端 skill。 - 若项目存在接口文档、OpenAPI、IDL 或既有同域接口，先读取并沿用约定。
工作流
- 明确调用方、接口职责、请求/响应模型、错误语义和兼容边界。
- 区分新增接口、兼容性修改和破坏性修改；破坏性修改必须给迁移或灰度方案。
- 核对鉴权、权限、数据隔离、幂等、重复提交、分页、排序、批量规模和超时行为。
- 明确 DTO 与持久化对象、领域对象、页面展示模型之间的转换边界。
- 输出联调和回归路径，覆盖成功、失败、空数据、越权、重复请求和大数据量。
必查项
- 请求字段是否有必填、默认值、枚举和长度范围。
- 响应字段是否稳定，是否存在可空字段和兼容兜底。
- 错误码或异常是否能被调用方区分和处理。
- 写接口是否具备幂等、防重复提交或唯一约束。
- 批量接口是否有规模上限、分批策略和部分失败语义。
输出格式
- 接口范围
- 请求/响应契约
- 权限与幂等
- 兼容性风险
- 验证与联调建议
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