面向后端Go语言开发者的技术说明文档需明确使用对象、采用五段式骨架（本质功能、高频问题、调用示例、设计约束、已知缺陷），并强制格式规范与术语统一，确保信息精准直达目标读者。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
明确文档对象与核心用途
你要生成的不是代码注释，而是给其他工程师看的技术说明文档，必须让读者一眼看清“谁在什么场景下用、怎么用、为什么这么设计”。不写清楚使用对象，AI会默认面向初学者堆砌基础概念，导致资深开发人员跳过阅读。
在提示词开头直接锁定读者身份：例如“面向后端Go语言开发者”“面向前端React 18团队”“面向运维部署人员”，不能只说“技术人员”这种空泛表述。【身份模糊会导致输出内容颗粒度失控，要么太浅、要么太深】。
构建五段式技术文档骨架
第一步：用一句话定义该模块/接口/组件的本质功能，不带修饰词。例如：“/v1/order/create 是同步创建订单的HTTP POST接口，幂等性由client_id + order_sn联合保证。”
第二步：列出3个最常被问到的实际问题，每个问题后紧跟一句直给答案。例如：“Q：并发调用是否安全？→ A：是，内部已加分布式锁，锁粒度为user_id。”
第三步：给出一个最小可运行调用示例，含完整请求头、JSON body、响应体（含status code），字段名必须与线上真实字段完全一致，不能用“xxx”或“示例值”占位。
第四步：标出2个关键设计约束及其原因。例如：“必须校验X-Request-ID：用于全链路日志追踪，缺失将导致SRE无法定位超时请求。”
第五步：注明1处已知缺陷或边界限制，不美化不回避。例如：“当前不支持order_type=refund的批量创建，该能力计划Q3上线。”
嵌入格式与术语强制规则
方法一：指定字体与结构标记
在提示词末尾加一句：“所有标题用#号标记，一级标题#，二级标题##；所有代码块用```包围；所有API路径、参数名、状态码、错误码全部用`反引号`包裹；禁用‘我们’‘建议’‘可以’等主观表述，全部改为陈述句。”
方法二：注入术语对照表
若项目有内部术语，必须显式声明映射关系。例如：“请将‘履约单’统一写作‘fulfillment_order’，‘仓配’统一写作‘warehouse_logistics’，‘兜底策略’统一写作‘fallback_policy’。”
注意：未声明的缩写首次出现时必须括号标注全称，如“SLA（Service Level Agreement）”，否则AI会直接使用缩写造成理解断层。
