答案是：需用角色+模板锚点锁定结构、反例排除法压缩幻觉、字段映射强约束，并通过自检清单逐项补全，才能生成可直接交付开发的标准接口文档。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让豆包生成一份结构清晰、字段完整、可直接交付开发的接口文档，但默认提示词只能产出零散信息或格式混乱的内容。
普通版提示词：先让豆包知道“这是接口文档”
输入：“写一个用户登录接口的文档。”
这句提示词太模糊。豆包不知道你指 REST 还是 GraphQL，不清楚是否要状态码、请求头、错误示例，甚至可能把返回字段写成“返回成功或失败”，根本没法用。
改成：“请用标准 Markdown 格式，写一份用户登录接口的 RESTful 文档，包含接口路径、请求方式、请求头、请求参数（含必填/选填说明）、成功响应字段、常见错误码及含义。”
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
这一步的关键是【必须明确指定输出格式和核心模块】，否则豆包默认按自由文本组织，不会主动分栏、加粗字段名、标注 required。
进阶版提示词：控制结构+约束边界+注入业务语义
方法一：用角色+模板锚点锁定输出结构
“你是一名后端 API 文档工程师，请严格按以下结构输出：# 接口名称｜# 请求地址｜# 请求方式｜# 请求头｜# 请求参数（表格：字段名｜类型｜是否必填｜说明）｜# 响应示例（JSON 格式，缩进 2 空格）｜# 错误码表（状态码｜错误码｜说明）。现在生成「手机号一键登录」接口文档，其中短信验证码需校验 5 分钟有效期，token 有效期为 7 天，且返回的 user_info 中必须包含 avatar_url、nickname、bind_status（0-未绑定微信，1-已绑定）。”
使用豆包（火山引擎 Ark）生成图片或视频并保存本地。用户提及“豆包生图/图片/生视频/视频”、“Doubao”、“Seedance”、“火山引擎图片/视频”时触发。
方法二：用反例排除法压缩幻觉空间
“不要写‘详见后端代码’‘具体逻辑由服务端决定’这类无效描述；不要省略 Content-Type 示例；不要把 error_code 写成字符串如 'invalid_phone' 而不给出数字码（如 40012）；不要在响应字段里出现‘等等’‘其他字段略’。”
【必须禁用模糊表述，否则豆包会用概括性语言绕过细节】
方法三：带字段映射关系的强约束
“请求参数中 phone 字段类型为 string，长度 11，需符合中国大陆手机号正则 ^1[3-9]\d{9}$；code 字段为 6 位纯数字 string；返回字段 login_token 类型为 string，长度 ≥ 32；refresh_token 同样为 string，但必须注明‘仅首次登录返回，后续调用 refresh 接口获取新 token’。”
这一步操作起来很简单，直接把字段规则像填表一样列清楚就行。但漏掉正则或 token 生效条件，开发联调时就会卡在“为什么我传了 11 位号还报错”。
终极校验：用“文档自检清单”倒逼提示词补全
第一步：列出你实际需要交付给前端/测试的最小可用项——比如“必须能复制粘贴进 Swagger 导入”“错误码表要能直接转成枚举类”“所有字段名必须和 Java DTO 字段名完全一致”。
第二步：对照清单，检查当前提示词是否覆盖每一项。缺哪条就补哪条，例如发现没提 DTO 字段名一致性，就加一句：“所有请求参数名与响应字段名，须与 Spring Boot 控制器中 @RequestBody 和 @ResponseBody 对应的 Java Bean 字段名严格一致，包括大小写和下划线/驼峰风格。”
第三步：把最终提示词粘贴进豆包，立刻看它输出的第一行是不是“# 接口名称”。如果不是，说明结构锚点失效，要回到方法一强化标题符号或加“请勿添加额外解释性文字”。
