必须人工标定接口四元组锚点并强制结构化示例：get|/users/{id}|id|username,email；禁用修饰语；字段冻结法限定表格列与格式；动词-名词绑定法统一动词映射；分步校验路径唯一性与参数一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Trae中为接口编写调用示例提示词时，若未约束参数命名、响应结构与动词粒度，AI常将同一接口生成多套表面不同但语义重叠的示例，例如“调用/user/info获取用户信息”“发起GET请求查询用户详情”“向用户信息端点发送查询请求”，三者实际指向完全相同的HTTP动作。这种重复不仅拉长文档长度，更导致开发者在阅读时需人工比对语义一致性。
锁定接口唯一锚点表达
打开你的OpenAPI 3.0规范文件或Swagger UI页面，在每个接口路径旁手动标注【HTTP方法+路径+核心参数名+关键响应字段】四元组，例如GET /api/v1/users/{id}标注为“GET|/users/{id}|id|userName,email”。这四个元素构成不可替换的锚点，后续所有示例必须严格包含且仅围绕它们展开。
跳过“请求成功后”“正常情况下”“建议开发者注意”等修饰性短语——它们不携带接口契约信息，却会触发AI生成多个变体描述。
【必须人工标定，不能依赖Trae自动识别】AI无法从JSON Schema中自主提炼出“id是路径变量而非查询参数”这类语义边界，只有你明确写出{id}，它才不会把{id}、?id=、body.id混为一谈。
强制使用结构化示例模板
方法一：字段冻结法
在提示词中直接嵌入如下表格结构，禁止AI自由换行或增删列：
│请求方式│URL路径│请求头│URL参数│请求体│预期响应状态码│关键响应字段示例│
要求：“请求方式”列仅允许填GET/POST/PUT/DELETE；“URL路径”必须完整保留{path}占位符；“关键响应字段示例”必须以{"userName": "test", "email": "t@x.com"}格式呈现，不允许写“返回用户名和邮箱”这类自然语言。
方法二：动词-名词绑定法
在提示词末尾追加术语映射表：
【动词约束表】
“获取” → 统一用“调用…接口”
“提交” → 统一用“向…接口发送POST请求”
“更新” → 统一用“向…接口发送PUT请求”
“删除” → 统一用“向…接口发送DELETE请求”
AI将按此映射实时替换，避免“调用/发送/执行/触发/访问”五种动词在同一个接口下反复出现。
分步生成并校验锚点一致性
第一步：让Trae仅输出“请求方式”和“URL路径”两列，不生成任何参数或响应内容；
第二步：对输出结果运行去重命令：RunCommand: awk -F'\t' '{print $1,$2}' examples.tsv | sort -u | wc -l；
第三步：若该命令返回值小于原始行数，则说明存在路径重复（如GET /users 和 GET /users/），立即终止流程；
第四步：仅当第二步通过后，才允许Trae填充URL参数列——此时参数名必须来自你第一步标定的四元组中的“核心参数名”，【若出现id、userId、user_id三者共存，即刻报错】。
