请严格分两步响应:① 先用‘【结构框架】’为标题,只列出6个必须包含的模块标题,每个标题后紧跟括号注明该模块需填写的具体字段名或校验项(如‘请求头(authorization字段格式、x-trace-id是否必传)’);② 再用‘【对接说明】’为标题,逐项填充上述模块内容。现在只输出第一步。【结构框架】1. 接口地址(http方法+完整路径+环境域名)2. 请求头(authorization字段格式、x-request-id是否必传)3. 请求体字段清单(字段名、类型、是否必填、示例值、枚举范围)4. 响应状态码表(code、reason、触发条件)5. 签名规则(算法、密钥来源、参与签名字段列表)6. 回调通知(url路径、http方法、重试机制、幂等key字段名)
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Trae的AI在生成接口对接说明前,先输出可验证、带编号、含字段名和校验方式的结构框架,而不是直接写大段描述——否则对接方无法快速定位字段含义、必填规则或错误码含义。
用结构化指令锁死AI输出顺序
在Trae Chat中新建对话,输入以下提示词(一字不改,不增空行、不加说明):
“请严格分两步响应:① 先用‘【结构框架】’为标题,只列出6个必须包含的模块标题,每个标题后紧跟括号注明该模块需填写的具体字段名或校验项(如‘请求头(Authorization字段格式、X-Trace-ID是否必传)’);② 再用‘【对接说明】’为标题,逐项填充上述模块内容。现在只输出第一步。”
【若AI跳过第一步直接写说明,或回复“好的”“已理解”,说明指令未生效,必须清空对话重发原提示词】
校验结构框架是否满足硬约束
拿到AI输出的6个模块后,立刻做三道卡口验证:
① 每个模块是否能映射到一个可交付物?例如“签名规则”模块必须明确写出算法名称(如HMAC-SHA256)、密钥来源(如env.SIGNING_KEY)、参与签名字段列表(如method+path+body),不能只写“按规范签名”。
② 是否全部避开模糊动词?如“需注意”“建议校验”“应当包含”属于禁用表述,必须替换为“□ 必须校验response.code=200”或“□ body中order_id字段长度≤32且仅含数字字母”。
③ 是否有至少3个模块含可截图/可命令验证的要素?例如“回调地址白名单(/etc/app/config.yaml第12行whitelist_ips数组必须含192.168.10.5)”就合格,“安全配置”就不合格。
补全结构时强制绑定字段与路径
方法一:在提示词末尾追加范例(不换行,紧接在上一段之后):
【结构框架】
1. 接口地址(HTTP方法+完整路径+环境域名,如POST https://api-prod.example.com/v3/order/create)
2. 请求头(Authorization字段值格式、X-Request-ID是否自动生成)
3. 请求体字段清单(字段名、类型、是否必填、示例值、枚举范围)
4. 响应状态码表(code、reason、触发条件,如401→token过期且refresh_token无效)
5. 签名规则(算法、密钥位置、参与签名字段顺序)
6. 回调通知(URL路径、HTTP方法、重试机制、幂等key字段名)
【对接说明】
方法二:反向排除法,在范例后加一句:“若你输出的任意模块标题不含括号内具体字段名或路径,整条重写。”











