DeepSeek生成的接口联调问题排查提示词需按平台定制:内部Wiki强调执行刚性与锚点导航;飞书适配卡片联动与@角色协同;GitHub模板严格匹配label、assignee及自动化脚本编号。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把DeepSeek生成的接口联调问题排查提示词,直接贴进不同发布平台(如内部Wiki、飞书知识库、GitHub Issues模板)就能用,但原提示词若照搬会漏掉平台关键字段、格式错乱、甚至被系统过滤——比如飞书自动吞掉反引号代码块,GitHub Issues模板不识别「请用✅❌符号」这类指令。
内部Wiki版本:嵌入可点击的故障树导航
第一步:在提示词开头加一句“本页用于一线开发同学自助排查HTTP接口5xx错误”,明确使用场景和读者身份。
第二步:把原提示词中“列出可能原因”改成“按以下路径逐层点开→【网络层】→【服务端中间件】→【下游依赖】→【数据库连接】”,每个节点用双星号包裹,方便Wiki支持锚点跳转。
第三步:所有排查命令必须带复制按钮标识,例如curl -v http://api.example.com/health → 改为「执行:【复制运行】 curl -v http://api.example.com/health」。
第四步:删掉所有“建议”“可以尝试”等弱动词,全部换成“必须验证”“立即检查”“确认已重启”。【Wiki页面一旦发布即作为SOP引用,语气必须具备执行刚性】
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
飞书知识库版本:适配@成员+卡片联动
方法一:把原提示词中的“检查Nginx日志”替换为「打开飞书日志卡片→选择【prod-api】环境→筛选status=502→点击【关联告警】查看最近3次触发」。
方法二:所有需要多人协同的动作,必须插入@角色,例如“数据库连接超时”对应步骤写成「@DBA负责人 确认max_connections是否已达阈值」。
方法三:禁用反引号,所有代码段改用「代码段」组件标识,例如将tail -f /var/log/nginx/error.log改为「代码段:tail -f /var/log/nginx/error.log」。
注意:飞书会自动折叠含“http://”的长链接,所以原始URL必须缩短并附说明,比如“查看监控大盘”后面紧跟(短链:feishu.cn/xxx,指向Grafana实时面板)。
GitHub Issues模板版本:严格匹配label与assignee规则
① 在提示词最开头插入固定字段:
```
---
name: 接口联调异常
about: 用于快速定位跨服务HTTP调用失败原因
labels: area/api, severity/P1, type/troubleshooting
assignees: backend-oncall
---
```
② 将原提示词中“描述现象”强制拆解为三个必填字段:
【请求路径】(例:POST /v2/order/create)
【复现频率】(单次/偶发/持续)
【上下游服务名】(例:caller=payment-gateway,callee=inventory-service)
③ 所有排查动作必须对应到GitHub Actions可触发的自动化脚本编号,例如“检查TLS版本”后注明(对应脚本:tls-check-v1.3,见.github/workflows/tls.yml)
④ 删除全部人称代词和语气词,禁止出现“你”“请”“我们”,只保留客观动作指令。例如“你应该查看header” → 改为“提取Response Header中X-Request-ID字段”。


















