hellowind777/hello-api
skills/hello-api/SKILL.md
构建、修改或审查 REST API、GraphQL 端点、webhook、中间件、请求/响应处理、API 版本管理、限流或分页时使用。
$ install --global
skillsauthnpx skillsauth add hellowind777/helloagents hello-apiInstall 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: May 3, 2026, 3:14 AM324.3s1 file scanned
SKILL.md
- name:
- hello-api
- description:
- 构建、修改或审查 REST API、GraphQL 端点、webhook、中间件、请求/响应处理、API 版本管理、限流或分页时使用。
API 相关代码必须遵循以下规范。
编码前
先确定资源模型和端点契约，再写代码。
RESTful 设计
- 资源命名：复数名词
/users，嵌套/users/:id/posts - HTTP 方法语义：GET 读、POST 创建、PUT 全量更新、PATCH 部分更新、DELETE 删除
- 状态码准确：200 成功、201 创建、204 无内容、400 参数错误、401 未认证、403 无权限、404 不存在、409 冲突、422 验证失败、500 服务端错误
请求验证
- 入参验证在 controller 层，使用 schema 验证库（zod、joi、ajv）
- 验证类型、范围、格式、必填
- 文件上传限制大小和类型
- 请求体大小限制
响应格式
- 统一成功响应：
{ data, meta? } - 统一错误响应：
{ error: { code, message, details? } } - 列表接口必须分页：
?page=1&limit=20或 cursor-based - 支持排序：
?sort=created_at&order=desc - 过滤参数白名单
版本与保护
- API 版本化：URL 前缀
/v1/或 header - 限流保护：按 IP/用户/API key
- 超时设置：所有外部调用设超时
- CORS：明确允许的 origin，不用
*
交付检查
- [ ] 状态码准确反映操作结果
- [ ] 所有入参已验证
- [ ] 列表接口有分页
- [ ] 错误响应格式统一
- [ ] 有限流保护
Related Skills
hellowind777/hello-subagent
data-ai
VerifiedTrustedCommunity
使用子代理执行任务、并行开发、分派工作时使用。确保子代理有清晰的上下文和验证标准。
600SKILL.mdUpdated May 3, 2026
hellowind777/qa-review
testing
VerifiedTrustedCommunity
统一质量审查、命令验证、阻断修复与交付前质量闭环。
599SKILL.mdUpdated May 22, 2026
hellowind777/~qa
testing
VerifiedTrustedCommunity
统一质量命令 — 审查、命令验证、阻断修复、回归验证与收尾前质量闭环（~qa 命令）
599SKILL.mdUpdated May 22, 2026
hellowind777/helloagents
data-ai
VerifiedTrustedCommunity
按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量
599SKILL.mdUpdated May 3, 2026