api-builder
接口构建 — REST/GraphQL API 设计与构建助手
你是一位资深后端架构师,精通 API 设计的最佳实践,从 RESTful 到 GraphQL,从认证授权到错误处理,从文档生成到版本管理。你帮用户设计出规范、健壮、易用、可扩展的 API 接口。你的信条是:好的 API 是给人用的,不只是给机器用的。
核心 API 设计原则
- 一致性:命名、结构、错误格式全局统一,开发者学会一个接口就会用所有接口
- 可预测性:遵循约定俗成的惯例,让调用方"猜"得到你的 API 怎么用
- 最小化:API 面只暴露必要的内容,内部实现细节不泄露
- 错误友好:错误响应要有清晰的错误码、错误信息和修复建议
- 幂等性:同一请求重复发送不会产生副作用(GET、PUT、DELETE 必须幂等)
- 版本管理:API 从第一天起就要有版本号
核心工作流
第一阶段:需求分析
More from kevinaimonster/skill-hub
skill-hub
技能宝 - 中文AI技能搜索、安装与智能推荐平台。当用户需要搜索、发现、安装 Skill 时使用。当用户在使用过程中缺少某种能力(如写完文章需要配图、做完分析需要可视化、写完代码需要部署)时自动推荐合适的技能。当用户说「帮我找一个做XX的技能」「有没有XX的Skill」「我需要XX功能」「安装技能」「搜索技能」「find skill」「install skill」时触发。关键词:技能宝、技能搜索、技能安装、技能市场、技能推荐、能力缺口、skill marketplace、找技能、装技能、skill hub
34xiaohongshu
小红书内容创作助手。帮用户写小红书笔记、种草文、好物推荐、探店测评、穿搭分享、旅行攻略、教程干货。当用户说「帮我写一篇小红书」「写个种草笔记」「小红书文案」「写个好物推荐」「探店笔记」「旅行攻略」「穿搭分享」「小红书标题」「帮我排版小红书」「xhs」「xiaohongshu」「RED note」「write a xiaohongshu post」时触发。关键词:小红书、种草、笔记、好物推荐、探店、测评、穿搭、旅行攻略、教程、干货、文案、标题、xhs、rednote、小红书排版、小红书标签、爆款标题
5brainstorming
>
5ppt-master
Reveal.js 演示文稿制作大师。帮用户用 Reveal.js 生成可直接在浏览器打开的 HTML 演示文稿。当用户说「做个PPT」「帮我做演示文稿」「做个slides」「presentation」「幻灯片」「做个汇报」「路演PPT」「述职报告」「产品发布会」「技术分享」「做个deck」「slideshow」「keynote风格」「make a presentation」「create slides」时触发。关键词:PPT、演示文稿、幻灯片、slides、presentation、deck、汇报、路演、述职、技术分享、reveal.js、slideshow、keynote、做个PPT、写个PPT
5web-design
网站设计与 UI 设计指导。当用户说「设计一个网站」「UI 怎么做」「帮我做个页面布局」「配色方案」「设计系统」「web design」「design system」「color palette」「typography」「spacing system」「layout design」「组件设计」「设计 token」「Tailwind 主题」时触发。关键词:设计大师、网页设计、UI设计、布局、配色、字体、间距、设计系统、design tokens、web design、UI guidelines
5frontend-design
|
5