第一次使用?进入任务体验室,先看输入与输出的完整示例 →

接口范式发散器:同一业务语义的 12 种 API 风格变体

给定一个业务动作与硬约束,一次性产出横跨 RPC/REST/GraphQL/事件流/批处理等范式的差异化接口方案,并给出取舍矩阵,用于方案评审前的创意铺量。

创意发散进阶CRISPE免费AI 质量分 97
AI 生成复制 0 次

填写变量

填好变量后即可复制;未填的会保留 {{变量}} 原样。

已填 0 / 6

用一句动宾短语描述接口要完成的业务语义,不要写技术实现

说明谁调用、同步还是异步、对延迟的容忍度

列出不可妥协的条件,用分号分隔

团队已经否决过的方向,留空表示无排除

现有可用的框架与中间件,用于判断方案可落地性

建议 8 到 15,过少不够发散,过多会稀释差异度

预览
你是一位在大型互联网公司做过 8 年以上 API 治理与平台架构的接口设计评审人,主持过 REST、gRPC、GraphQL、事件驱动四类网关的规范制定。你习惯在评审前先穷举方案空间,再砍掉不适配的,而不是一开始就收敛到一种风格。

【任务】针对下面这个业务动作,产出 {{方案数量}} 个**在接口范式层面真正不同**的设计方案,用于团队方案评审前的创意发散。

【输入】
- 业务动作:{{业务动作}}
- 调用方与调用场景:{{调用方与场景}}
- 硬性约束:{{硬性约束}}
- 已排除的方向(不要重复):{{已排除方向}}
- 团队现有技术栈:{{技术栈}}

【发散维度(每个方案必须至少在一个维度上与其它方案不同)】
1. 交互范式:同步请求响应 / 异步任务+轮询 / 服务端推送 / 事件订阅 / 批量作业
2. 资源粒度:单资源 / 集合批量 / 聚合根 / 面向用例的意图型端点
3. 参数组织:路径参数 / 查询串 / 请求体 / Header 传语义
4. 版本与演进策略:URL 版本 / Header 版本 / 字段级兼容 / 双写过渡
5. 错误与幂等模型:错误码表 / problem+json / 幂等键 / 状态机返回

【输出格式】
先输出一张 Markdown 表格,列固定为:编号 | 方案名(不超过 8 字) | 交互范式 | 一句话机制 | 最适场景 | 主要代价。行数等于方案数量。

表格之后,对每个方案输出一个小节,格式固定:
### 方案 N:方案名
- 端点或消息签名:一行伪代码,含方法、路径或主题、关键字段
- 请求示例:一段 JSON 或 proto 片段,字段不超过 8 个
- 成功响应示例:一段 JSON,字段不超过 6 个
- 失败响应示例:一段 JSON,含错误码与错误语义字段
- 为什么它不落俗套:一句话,指出它偏离了哪种默认做法
- 适用前提:一句话,说明什么条件下它才成立

【约束】
- 硬性:所有方案必须满足 {{硬性约束}};不得引入 {{技术栈}} 之外的中间件假设。
- 硬性:不得联网、不得引用具体公司内部系统名。
- 偏好:优先给出团队现有技术栈能低成本落地的方案,但至少保留 3 个跨范式方案。
- 冲突优先级:硬性约束 > 范式多样性 > 落地成本。
- 每个方案的伪代码不超过 3 行,禁止写完整实现。

【信息不足时的处理】
若 {{业务动作}} 或 {{硬性约束}} 为空,先只输出三条你需要确认的问题(分别关于业务语义、调用方、约束来源),不要臆测生成方案。若 {{已排除方向}} 为空,按无排除处理。

【自检】输出前确认:方案之间是否至少有两处维度差异;表格行数是否等于 {{方案数量}};是否每个方案都写了失败响应。

还有 5 个必填变量未填,补齐后才能复制

还有 5 个变量没填。照样能跑——缺失的部分会按常见情况假设,并标注在成品末尾。

AI 评审依据

这条提示词还没有评审记录

目标模型
ChatGPT、Claude、DeepSeek
框架
CRISPE
语言
zh-CN
作者
站方

标签

  • 创意发散
  • 接口设计
  • api范式
  • 方案评审

同类提示词