MarsCode生成API接入说明前必须先输出4条可验证标准：①含具体字段名/数值/行为要求；②覆盖可量化指标、约束条件、业务对齐项三类硬性要素；③每条标准须能通过截图/代码/抓包日志当场验证，缺一不可。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让marscode在生成api接入说明前，先明确判断这份文档是否能真正被后端同学拿来就用——而不是写一堆“调用方式”“返回示例”后，对方还得反复问你“签名怎么算”“重试机制是客户端还是服务端控制”“超时时间设多少才不丢请求”。

第一步：强制AI只输出标准，不写说明

在MarsCode输入框中粘贴以下提示词，一字不改，直接发送：

“你是一名有5年API平台对接经验的中间件工程师，负责为外部团队编写可落地的接入文档。我现在要生成一份【MarsCode插件调用/v3/auth/token】接口的接入说明，请严格按两步执行：① 先用‘【判断标准】’为标题，只列出4条核心标准，每条必须含具体字段名、数值或行为要求，且能通过截图/代码片段/抓包日志直接验证；② 等我回复‘确认’后再输出完整接入说明。现在只输出第一步。”

【若AI回复‘好的’‘已理解’或直接开始写‘1. 接口地址’，说明它跳过了标准环节——这是失效信号，必须中断并重发原提示词】。

第二步：标准必须含三类硬性要素

AI输出的4条标准里，必须同时覆盖以下三类要素，缺一不可：

方法一：可量化指标（如“签名字段sign长度固定32位”，不能写“签名需加密”）

方法二：约束条件（如“错误码401响应体必须含retry_after字段”，不能写“建议重试”）

方法三：业务对齐项（如“token有效期必须与OAuth2.0 RFC6749第5.1节一致”，不能写“时效合理”）

这一步操作起来很简单，直接扫一眼AI列的标准里有没有出现具体字段名、数字、RFC编号或协议名称——没有这些，就是无效标准。

第三步：逐条验证标准是否可打钩

第一步：把AI输出的第1条标准抄下来，打开Postman，手动构造一次请求→抓包→对照响应体检查是否满足。

第二步：把第2条标准中的字段名复制进MarsCode插件源码搜索框，确认该字段是否真实存在于request payload结构定义中。

第三步：把第3条标准提到的RFC章节号粘贴进浏览器，打开官方文档，核对描述是否完全一致。

第四步：把第4条标准里的数值（比如“超时阈值≤1500ms”）填入curl命令的--max-time参数，跑通一次失败请求，看是否真在1500ms处断开。

【只要有一条标准无法用上述方式当场验证，整套标准即判定为无效，必须叫停并要求重列】。