三份文档严格按角色切分：【契约确认版】含字段校验、幂等性说明、索引建议；【调用速查版】含axios示例、loading时机、兜底策略；【验证要点版】覆盖全状态组合、越界响应、空结果http码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要为同一接口生成三份对接说明文档，但豆包每次只输出技术参数罗列，缺少面向不同角色的视角切分——后端要契约细节，前端要调用路径，测试要验证边界，三者混在一起反而谁都不好用。
用角色锚定法一次性生成三角度文档
第一步：在豆包输入框首行写明双重身份——“你既是API平台负责人，也是跨职能协作教练”。
第二步：紧接着输入任务指令：“请为订单查询接口（GET /api/v1/orders，支持page、size、status三个查询参数）生成三份独立文档，每份严格对应以下角色视角：①给后端联调方看的契约确认版（含字段校验规则、幂等性说明、数据库索引建议）；②给前端同学看的调用速查版（带axios示例、loading时机、分页失败兜底策略）；③给测试工程师看的验证要点版（覆盖status=‘pending’/‘shipped’/‘cancelled’全状态组合、page=0与size=1000的越界响应、空结果集的HTTP状态码）”。
第三步：末尾加硬约束：“三份文档用【契约确认版】/【调用速查版】/【验证要点版】明确分隔；禁用‘详见代码’‘参考文档’等模糊指引；每份不超过220字；JSON示例必须缩进2空格，不加反引号”。
【若某版出现“建议前端加防抖”这类越界建议，需立即重写该版】
按平台入口适配生成结构化片段
方法一：Swagger场景直填
输入：“请为同一订单查询接口生成Swagger 3.0 YAML中paths部分的description字段内容，要求覆盖：①status参数取值枚举及业务含义（pending=已下单未支付，shipped=已发货，cancelled=已取消）；②page与size的默认值与最大限制；③返回数据中order_items数组的最小长度与item_id唯一性约束”。
Excel/CSV与飞书表格（多维表格/电子表格）双向转换工具。支持：1. 导入Excel到多维表格（创建新表或同步到现有表）；2. 从多维表格/电子表格导出数据为CSV或Excel格式。自动识别URL类型，智能推断字段类型。
方法二：Confluence页面嵌入段落
输入：“请生成一段适合直接粘贴到Confluence‘前端对接须知’页面的说明文字，包含✅成功调用路径 / ❌常见400错误归因（如status传错大小写、page为负数） / ?调试技巧（如何用curl -v验证header是否携带auth token）”。
方法三：飞书多维表格字段文案
输入：“请为飞书多维表格中‘文档用途’字段生成3个下拉选项文案，每个≤10字：①供后端确认字段契约用；②供前端快速接入用；③供测试设计用例用”。
用反向约束压缩幻觉空间
第一步：先发基础指令：“请生成订单查询接口的对接说明”。
第二步：收到回复后立刻追加：“删掉所有‘建议’‘可以’‘可能’类弱效词；把‘status参数用于筛选订单状态’改成‘status仅接受小写英文字符串，非法值返回400+error_code=10203’；将‘响应包含订单列表’明确为‘response.data为array，单次最多返回50条，空数组时data=[]且HTTP状态码仍为200’”。
这一步必须做，【豆包默认会用概括性语言绕过校验细节，不加反向约束就会漏掉status大小写敏感这种致命问题】。
