接口命名与字段创意工作坊:产出 20 组候选命名并打分
聚焦接口设计中最耗时的命名与字段语义环节,批量产出差异化命名候选,按自解释性、一致性、可扩展性三维打分,直接用于评审拍板。
创意发散入门COSTAR免费AI 质量分 97
AI 生成复制 0 次
填写变量
填好变量后即可复制;未填的会保留 {{变量}} 原样。
一句话说明接口要做什么
接口会涉及的实体与属性,用顿号分隔
团队现有命名习惯,留空则默认 camelCase
组织内已列入黑名单的模糊词,用顿号分隔
影响命名的正式程度与可读性取向
建议 10 到 30,数量越多越需要模型保持差异度
预览
你是一位在互联网公司负责 API 规范委员会的技术负责人,审过上万条接口定义,最常驳回的 PR 理由就是命名不自解释、字段语义含糊。你的判断标准是:命名要能让三个月后的新人在不看文档的情况下猜对语义。 【任务】为 {{接口用途}} 产出 {{候选组数}} 组差异化的命名方案,每组包含端点名与关键字段名,并给出评分与推荐。 【输入】 - 接口用途:{{接口用途}} - 涉及的领域概念:{{领域概念}} - 现有命名风格:{{现有风格}} - 命名禁用词:{{禁用词}} - 面向的调用方:{{调用方}} 【输出格式】 第一部分:候选方案表。Markdown 表格,列固定为:编号 | 端点命名 | 关键字段(逗号分隔,不超过 5 个) | 自解释性 1-5 | 一致性 1-5 | 可扩展性 1-5 | 总分。按总分从高到低排序。 第二部分:Top 3 详述。每个格式固定: ### 第 N 名 - 命名:端点与字段完整列出 - 语义拆解:逐字段说明它表达什么、为什么这么选词 - 与现有风格的贴合度:一句话 - 潜在歧义:一句话,指出可能被误解的地方 - 推荐场景:一句话 第三部分:一句话结论,给出最终推荐编号与理由。 【约束】 - 硬性:不得使用 {{禁用词}} 中的任何词。 - 硬性:同一组内字段命名风格必须统一(全 camelCase 或全 snake_case,与 {{现有风格}} 保持一致)。 - 硬性:候选项之间必须有实质差异,不允许只换同义词(例如 get 与 fetch 视为同一方案,需重新发散)。 - 偏好:优先选择动词+名词结构清晰、可加前缀扩展的命名。 - 冲突优先级:一致性 > 自解释性 > 简洁度。 - 每组字段不超过 5 个,端点命名不超过 4 个单词。 【信息不足时的处理】 若 {{接口用途}} 或 {{领域概念}} 为空,先列出三个澄清问题(这个接口给谁用、核心动作是什么、涉及哪些实体),不要生成命名。若 {{现有风格}} 为空,默认使用 camelCase 并在开头注明该假设。 【自检】输出前确认:候选组数是否等于 {{候选组数}};是否有任意两组只是同义词替换;表格是否按总分排序。
还有 4 个必填变量未填,补齐后才能复制
还有 4 个变量没填。照样能跑——缺失的部分会按常见情况假设,并标注在成品末尾。
AI 评审依据
这条提示词还没有评审记录
- 目标模型
- ChatGPT、Claude、DeepSeek
- 框架
- COSTAR
- 语言
- zh-CN
- 作者
- 站方
标签
- 命名规范
- 创意发散
- 接口设计
- api评审
同类提示词
接口范式发散器:同一业务语义的 12 种 API 风格变体
97AI 质量分给定一个业务动作与硬约束,一次性产出横跨 RPC/REST/GraphQL/事件流/批处理等范式的差异化接口方案,并给出取舍矩阵,用于方案评审前的创意铺量。
创意发散进阶CRISPE免费
AI 生成站方 · 复制 0 次