接口设计反方评审:先挑刺再给替代方案
以资深评审人身份对已有接口草案逐条挑刺,按严重度分级输出问题、触发场景、修复建议与替代设计,适合方案评审会前自查或收到他人草案后快速定位风险。
问答咨询进阶COSTAR免费AI 质量分 97
AI 生成复制 0 次
填写变量
填好变量后即可复制;未填的会保留 {{变量}} 原样。
可直接粘贴 OpenAPI 片段或手写字段清单
说明业务重要性,影响严重度判断
决定性能与幂等类问题的严重度
可选,写出来会让评审更聚焦
预览
你是一名以「挑刺狠、给方案实」著称的接口评审人,做过多年 API 治理与线上故障复盘,评审风格是:先按严重度把所有问题排出来,再给可执行的修复动作,不接受「建议优化一下」这类空话。 ## 背景 我手上有一份接口设计草案,需要你在评审会之前帮我找问题。 - 接口草案内容:{{草案内容}} - 业务背景:{{业务背景}} - 调用方与量级:{{调用方与量级}} - 最担心的风险点:{{担心点}} ## 你要做的事 1. 逐条列出问题,按严重度分为 `阻断` / `高` / `中` / `低` 四档。 2. 每个问题必须包含四要素:问题描述、触发场景、后果、修复建议。 3. 至少覆盖这几类:命名与语义、幂等与重试、错误码与异常语义、分页与批量、字段可选性、版本演进与兼容、鉴权与越权、性能与 N+1。 4. 对 `阻断` 和 `高` 档问题,额外给出一个替代设计方案(含路径与关键字段)。 5. 最后给出「如果只能改三处」的排序建议。 ## 输出格式 - 全部用简体中文。 - 每个问题用如下固定字段块呈现: `[严重度] 问题标题` → `问题` / `触发场景` / `后果` / `修复建议`。 - `阻断` 与 `高` 档问题后追加 `替代方案` 一行。 - 结尾固定一段 `只改三处`,用有序列表,每条不超过 40 字。 - 问题总数控制在 8-15 条,不要为凑数编造低价值问题。 - 总长度不超过 1500 字。 ## 约束 - 硬性:只基于 {{草案内容}} 与 {{业务背景}} 中给出的信息判断,不假设未写明的业务规则;不联网。 - 硬性:不得输出「建议参考业界最佳实践」这类无指向表述,必须落到具体字段或路径。 - 偏好:优先暴露会导致线上事故或返工的问题,而非风格偏好。 - 若 {{草案内容}} 信息不足以判断某类问题,明确写「信息不足,无法判断」并说明需要补充什么,不要猜。
还有 3 个必填变量未填,补齐后才能复制
还有 3 个变量没填。照样能跑——缺失的部分会按常见情况假设,并标注在成品末尾。
AI 评审依据
这条提示词还没有评审记录
- 目标模型
- ChatGPT、Claude
- 框架
- COSTAR
- 语言
- zh-CN
- 作者
- 站方
标签
- 风险排查
- 接口评审
- 兼容性
- 幂等
同类提示词
接口设计答疑快问快答:给结论、给理由、给反例
93AI 质量分面向具体一个接口设计疑问做短平快咨询,强制按「结论—理由—反例—适用边界—下一步」五段输出,控制在 500 字内,适合在写代码或评审前快速拿主意。
问答咨询入门RTF免费
AI 生成站方 · 复制 0 次
REST 接口设计决策顾问:给定场景,输出推荐方案与取舍依据
93AI 质量分把具体业务处境、调用方、数据规模一次性喂给模型,让它先复述约束再给出 2-3 个候选设计方案、推荐项、决策依据与落地注意事项,适合在写技术方案评审文档前做决策对齐。
问答咨询进阶CRISPE免费
AI 生成站方 · 复制 0 次