请面向【java spring boot 3.2+ 微服务架构下的后端开发工程师】撰写接口对接说明：默认熟悉openfeign、jwt鉴权与http状态码，但需解释自定义error_code=4102的业务语义；当调用/v2/shipment/confirm时，假设已获access_token，不重复oauth2流程；你可能会遇到timestamp单位混淆或signature验签失败，建议检查是否毫秒级时间戳及密钥拼接顺序。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让通义千问生成的接口对接说明文档精准匹配目标人群（比如后端工程师、第三方系统集成商或低代码平台使用者），而不是泛泛而谈的技术描述。这要求提示词中明确嵌入角色身份、知识背景、使用场景和常见困惑点，否则输出内容容易脱离实际落地需求。
明确指定目标人群身份与技术水位
在提示词开头直接写明“请面向【Java Spring Boot 3.2+ 微服务架构下的后端开发工程师】撰写”，不要用“技术人员”“开发者”这类模糊表述。这类工程师熟悉 OpenFeign、RestTemplate、JWT 鉴权流程，但可能不熟悉你方系统的内部状态机设计——所以后续说明里要默认他们懂 HTTP 状态码含义，但需解释你们自定义的 error_code=4102 的业务语义。
如果目标是低代码平台配置人员，就写成“请面向【熟悉 API 调用配置但不写代码的业务系统实施顾问】撰写”，他们需要字段映射示例、失败重试建议、超时时间填哪里，而不是 Maven 依赖坐标。
绑定具体使用场景和触发动作
方法一：用“当……时”句式锚定行为上下文。
例如：“当第三方系统需通过 Webhook 接收订单履约状态变更通知时，请说明如何配置签名验证逻辑。” 这样能迫使模型聚焦在真实调用链路中的一环，而非堆砌通用 API 文档术语。
方法二：给出前置条件限制。
例如：“假设对方已获取 access_token 且仅需调用 /v2/shipment/confirm 接口，不涉及鉴权流程复述。” 避免模型重复输出 OAuth2 流程，节省阅读成本。
【若未声明前置条件，模型大概率会从注册应用→申请 token→调用接口→错误排查全流程展开，导致关键步骤被稀释】
植入典型疑问与易错点
第一步：回忆该人群在同类对接中最常卡住的位置。比如支付回调验签，后端工程师常忽略 header 中 X-Signature 的 Base64 解码后再 HMAC-SHA256；低代码用户则常把 body raw JSON 错配成 form-data。
第二步：在提示词中直接列出 1～2 个真实问题。
例如：“请重点说明：① 时间戳参数 timestamp 是毫秒还是秒级，是否需与服务器时间误差小于 300 秒；② 当返回 code=500 但 message='invalid signature' 时，应检查密钥拼接顺序还是哈希算法版本？”
第三步：要求用“你可能会遇到……建议检查……”句式回应，而非被动陈述。
这一步操作起来很简单，直接把上述疑问复制进提示词末尾即可生效。但漏掉它，生成的文档就会缺少防御性指引。
