Codeium需严格按两阶段处理接口文档:①扫描出字段无类型声明、状态码未覆盖400/401/403/500、响应示例与字段说明冲突三类硬伤并定位具体位置;②针对每处缺陷给出【原句】→【修改后】格式的可粘贴修改建议,且必须结合锚点校验规则与分类型修复指令执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Codeium基于现有接口文档内容,自动识别字段缺失、类型模糊、状态码遗漏、示例不一致等硬伤,并给出可落地的修改建议,而不是泛泛而谈“请完善文档”。
让AI先定位问题再提建议
在Codeium编辑器中选中整段接口文档文本(含请求路径、方法、参数、响应体)→ 按 Ctrl+I 弹出指令框 → 粘贴以下提示词:
「请严格按两阶段处理:① 先扫描全文,逐条列出3类硬性缺陷(字段无类型声明、HTTP状态码未覆盖400/401/403/500、响应示例与字段说明冲突),每类至少1个真实位置(如“/user/login POST 响应体中‘token’字段未标注是否必填”);② 针对每个缺陷,给出1条可直接粘贴到文档中的修改建议,格式为【原句】→【修改后】。禁止添加解释性文字。」
这一步强制AI进入诊断模式——若跳过①直接输出建议,说明它没真正比对字段和示例,生成结果大概率是模板化套话。
用锚点锁定关键校验项
在原始文档末尾空一行,手动添加三行校验锚点:
// 必检项:所有string字段必须标注最大长度
// 必检项:每个4xx状态码需对应1个具体错误场景描述
// 必检项:响应示例中出现的字段,文档字段表里必须存在且类型一致
【锚点必须紧贴文档末尾,不能有空行,且每行以//开头】——Codeium会将这三行识别为硬性校验规则,而非普通注释;缺少任一锚点,AI会默认忽略对应维度的检查。
针对不同缺陷类型给不同修复指令
方法一:字段类型缺失 → 在提示词中追加:
「对所有未声明类型的字段,在字段说明末尾补上“(type: string/number/boolean/object/array)”,若为嵌套对象,需展开到二级字段」
方法二:状态码覆盖不全 → 在提示词中追加:
「在HTTP状态码表格下方新增一行:“400|参数校验失败|{“code”:400,“msg”:“xxx”}”,其中xxx必须来自实际业务错误文案,不可写“参数错误”」
方法三:响应示例与字段表冲突 → 在提示词中追加:
「对比响应JSON示例与字段说明表,若示例中存在字段表未列字段,立即在表末追加该字段行;若字段表有而示例缺失,则在示例对应层级插入该字段并赋典型值(如status: “active”)」
这三类指令必须分开写,混在一起会导致AI只执行最靠前的那条。

















