核心用法
REST Best Practices 是一款纯文档型架构指导技能，通过六阶段深度工作流帮助开发者设计符合 HTTP 语义规范的 RESTful API：
1. 资源建模：明确集合与单资源边界，定义规范 URL 与标识符体系
2. 方法与安全：严格区分 GET/HEAD（安全幂等）、POST（创建）、PUT（全量替换）、PATCH（局部更新）、DELETE（删除）的语义边界
3. 状态与错误：规范 4xx/5xx 状态码使用，采用 RFC 7807 Problem Details 统一错误体
4. 分页与过滤：推荐游标分页处理大数据量列表，文档化排序与过滤参数
5. 缓存与条件请求：通过 ETag/Last-Modified 实现可缓存 GET，配置 Cache-Control 指令
6. 版本演进：URL 前缀或 Header 版本控制，制定弃用策略，POST 重试场景使用 Idempotency-Key
技能最终输出可执行检查清单，并可与 OpenAPI 规范结合实现契约优先开发。
显著优点
- 权威性与系统性：完整覆盖 REST 设计的核心维度，从资源建模到版本演进形成闭环
- 零执行风险：纯 Markdown 文档，无代码、无依赖、无网络请求，安全审计满分
- 实战导向：内置反模式识别（如非幂等 GET、POST 过载），提供具体修正建议
- 可扩展性：支持 HATEOAS 可选实现，兼容非 CRUD 场景（命令建模为子资源）
潜在局限
- 非自动生成工具：仅提供设计规范与检查清单，不输出可直接运行的代码或配置
- 需人工落地：六阶段工作流需要架构师或技术负责人手动执行，无法一键完成
- HTTP 协议局限：专注 REST 风格，对 GraphQL、gRPC 等现代 API 范式无直接支持
- 个人维护来源：开发者 mike47512 为个人贡献者，长期维护持续性需关注社区反馈
适合人群
- 后端架构师：负责设计公共 API 或合作伙伴接口的技术决策者
- 技术评审者：审查现有控制器、网关实现是否符合 HTTP 语义规范
- 开发团队 Lead：建立团队 API 设计规范，统一代码评审标准
- 全栈开发者：需要深入理解 REST 设计原则以提升前后端协作效率
使用风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 代码执行风险 | 无 | 纯文档型技能，无可执行代码 |
| 数据隐私风险 | 无 | 无数据收集、无外部网络请求 |
| 依赖供应链风险 | 无 | 零第三方依赖 |
| 来源可信度风险 | 低 | T3 个人开发者，建议审查内容后使用 |
| 实际应用风险 | 中 | 设计建议需结合项目实际，生产环境需额外测试验证 |
建议用户通过 GitHub 等渠道验证开发者信誉，关注 Skill 版本更新，并在生产应用前进行独立的架构评审与压力测试。