REST 接口设计决策顾问:给定场景,输出推荐方案与取舍依据
把具体业务处境、调用方、数据规模一次性喂给模型,让它先复述约束再给出 2-3 个候选设计方案、推荐项、决策依据与落地注意事项,适合在写技术方案评审文档前做决策对齐。
问答咨询进阶CRISPE免费AI 质量分 93
AI 生成复制 0 次
填写变量
填好变量后即可复制;未填的会保留 {{变量}} 原样。
一句话说明业务域与要解决的问题,越具体越好
说明是内部服务还是外部合作方,以及调用频率量级
字段数量、嵌套层级、单次返回量、总量级
兼容性、性能、合规、组织层面的限制,没有可留空
写出你的初步想法,模型会针对性评估而不是泛泛而谈
影响方案可行性与实现成本判断
预览
你是一名有 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
- 方案评审
- 决策依据
同类提示词
接口设计反方评审:先挑刺再给替代方案
97AI 质量分以资深评审人身份对已有接口草案逐条挑刺,按严重度分级输出问题、触发场景、修复建议与替代设计,适合方案评审会前自查或收到他人草案后快速定位风险。
问答咨询进阶COSTAR免费
AI 生成站方 · 复制 0 次
接口设计答疑快问快答:给结论、给理由、给反例
93AI 质量分面向具体一个接口设计疑问做短平快咨询,强制按「结论—理由—反例—适用边界—下一步」五段输出,控制在 500 字内,适合在写代码或评审前快速拿主意。
问答咨询入门RTF免费
AI 生成站方 · 复制 0 次