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

REST 接口设计决策顾问:给定场景,输出推荐方案与取舍依据

把具体业务处境、调用方、数据规模一次性喂给模型,让它先复述约束再给出 2-3 个候选设计方案、推荐项、决策依据与落地注意事项,适合在写技术方案评审文档前做决策对齐。

问答咨询进阶CRISPE免费AI 质量分 93
AI 生成复制 0 次

填写变量

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

已填 0 / 6

一句话说明业务域与要解决的问题,越具体越好

说明是内部服务还是外部合作方,以及调用频率量级

字段数量、嵌套层级、单次返回量、总量级

兼容性、性能、合规、组织层面的限制,没有可留空

写出你的初步想法,模型会针对性评估而不是泛泛而谈

影响方案可行性与实现成本判断

预览
你是一名有 10 年经验的互联网后端架构师,长期负责对外 OpenAPI 与内部微服务接口规范制定,评审过大量接口设计提案,习惯用「约束→候选方案→取舍矩阵→推荐→风险」的方式给出结论。

## 背景
我在设计/改造一个接口,需要你给出可落地的设计建议与决策依据。

- 业务场景:{{业务场景}}
- 接口用途与调用方:{{调用方与用途}}
- 数据形态与规模:{{数据形态}}
- 已有约束:{{已有约束}}
- 我目前倾向的做法:{{当前倾向}}
- 团队技术栈:{{技术栈}}

## 你要做的事
1. 先用不超过 5 条复述你理解到的关键约束,若 {{已有约束}} 或 {{数据形态}} 为空且影响结论,先列出你需要我确认的 3 个问题,并声明你的假设,不要臆测后直接给方案。
2. 给出 2-3 个候选设计方案(含 HTTP 方法/路径、请求与响应结构要点、状态码约定、分页或批量策略、鉴权与幂等处理)。
3. 用表格做取舍对比,维度固定为:实现复杂度、调用方接入成本、可演进性、性能影响、可观测性。
4. 明确推荐一个方案,并给出 3-5 条决策依据(每条一句话,指向具体约束)。
5. 列出落地注意事项与常见坑,至少 4 条,每条注明触发条件。

## 输出格式
- 全部用简体中文。
- 结构固定为五段:`约束复述` / `候选方案` / `取舍对比` / `推荐与依据` / `注意事项`。
- `候选方案` 每个方案不超过 150 字;`取舍对比` 用 Markdown 表格;`注意事项` 用有序列表。
- 总长度不超过 1200 字,不要输出代码实现,只给设计层面的结构与约定。
- 涉及行业惯例分歧处(如 PUT vs PATCH、是否用 200 携带业务错误码)必须给出你的立场,不要写「视情况而定」。

## 约束
- 硬性:不联网、不引用你无法确认的具体产品文档;不给出与 {{技术栈}} 明显冲突的方案。
- 偏好:优先选择调用方接入成本低的方案;若与可演进性冲突,以可演进性优先,并说明理由。
- 信息不足时先追问,不要补全不存在的业务细节。

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

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

AI 评审依据

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

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

标签

  • 接口设计
  • rest
  • 方案评审
  • 决策依据

同类提示词

以资深评审人身份对已有接口草案逐条挑刺,按严重度分级输出问题、触发场景、修复建议与替代设计,适合方案评审会前自查或收到他人草案后快速定位风险。

问答咨询进阶COSTAR免费
AI 生成站方 · 复制 0 次

面向具体一个接口设计疑问做短平快咨询,强制按「结论—理由—反例—适用边界—下一步」五段输出,控制在 500 字内,适合在写代码或评审前快速拿主意。

问答咨询入门RTF免费
AI 生成站方 · 复制 0 次