结构说明:这是一篇行业场景聚合包,不是单条提示词长评,也不是「模型 A vs 模型 B」横评。下面把研发排障常用动作并列成 12 条可复制模板 + 行业约束块;你按岗位拿走,不必强行对比哪条「最强」。
适用人群:写业务的后端/全栈、值班同学、带模型做结对排障的人。场景边界:线上/预发缺陷、日志与堆栈、配置漂移、热修与复盘;不适用:从零设计架构、写营销文案、无日志的纯需求讨论。
我踩过的坑很具体:同一份报错,模型兴致勃勃改了三处无关配置,绿了表象、埋了雷。后来在系统提示里加硬约束——先复现路径,再给补丁;信息不够就问,不准猜着改。误改明显下降。下面按矩阵 → 全文模板 → 行业换皮 → 今晚怎么接到仓库 的顺序写。
适用人群与使用边界

- 你有日志、堆栈、或可描述的复现步骤(再糊也行,但不能完全没有)。
- 你愿意多一轮对话:先对齐复现,再接受 diff。
- 你能把提示词里的
{{变量}}换成真实材料;不要空跑。
不要用本包「证明模型很聪明」;用来减少值班时的手滑。若团队有正式 runbook,把本包当 runbook 的对话层,而不是替代监控与权限。
矩阵总览

| 提示词名 | Escenarios aplicables | 输入变量 | Resultados esperados |
|---|---|---|---|
| P01 日志复现路径梳理 | 拿到报错日志但原因不明 | {{log}} |
复现路径 + 缺失信息清单 |
| P02 同输入对比三种假说 | 多种根因都说得通 | {{现象}} |
≤3 个互斥假说 + 15 分钟验证步骤 |
| P03 堆栈 → 可疑帧标注 | Java/Python/Go 堆栈过长 | {{stack}} |
≤5 个可疑帧表 + 断点/日志点 |
| P04 回归用例先于补丁 | 准备改代码前 | {{bug}} |
Given/When/Then 用例 + 断言 |
| P05 配置/特性开关误伤检查 | 怀疑配置漂移 | {{change}} |
环境×开关影响面表 + 回滚命令草稿 |
| P06 间歇性故障时间线 | 偶现、难复现 | {{timeline_raw}} |
时间线 + 下一轮采集清单 |
| P07 SQL/慢查询只读分析 | 慢查询或锁等待 | {{sql}} |
只读分析 + EXPLAIN 验证模板 |
| P08 前后端责任切分 | 互相甩锅的接口 bug | {{spec}} {{symptom}} |
责任切分表 + 各端最小复现请求 |
| P09 热修与正式修分流 | 线上要立刻止血 | {{incident}} |
A 热修 / B 正式修大纲 + 风险 |
| P10 补丁审阅:专找误改 | 同事或模型已给出 diff | {{diff}} |
必须改 / 建议改 / 可忽略 三栏 |
| P11 依赖升级回归清单 | 升级库后行为异常 | {{lib}} {{from_ver}} {{to_ver}} |
破坏性变更检查表 + 灰度指标 |
| P12 复盘文档骨架 | 故障已恢复,要写复盘 | {{postmortem_notes}} |
复盘草稿(直接/促成根因 + TODO) |
选用建议:值班前 30 分钟先用 P01/P03;已有 diff 用 P10;止血用 P09;收尾用 P12。不要一次把 12 条塞进同一条系统提示——会糊。
完整提示词(可复制)

P01 日志复现路径梳理
场景:拿到报错日志但原因不明
你是资深后端。用户会粘贴日志/堆栈。你的任务分两步,禁止跳步:
1) 只输出「复现路径」:触发条件、相关模块、可疑提交范围、还缺哪些信息。不要给补丁。
2) 等用户回复「确认复现」或补充信息后,再给最小补丁(unified diff)与回归用例。
若信息不足,只列问题清单,不要猜测改代码。
日志/堆栈:
{{log}}
适用边界 / 翻车点:边界:无仓库上下文时禁止编造文件路径。翻车点:一上来就改配置。
P02 同输入对比三种假说
场景:多种根因都说得通
根据以下现象列出 ≤3 个互斥假说。每个假说必须包含:可观察证据、一次最低成本验证步骤、若成立应看到的结果。
禁止直接给「最终结论」或补丁。验证步骤必须我能在 15 分钟内做完。
现象:
{{现象}}
适用边界 / 翻车点:边界:假说过 3 个就合并。翻车点:假说彼此不互斥。
P03 堆栈 → 可疑帧标注
场景:Java/Python/Go 堆栈过长
阅读堆栈,输出表格:帧序号 | 文件:行 | 为何可疑(1句) | 建议打断点或日志点。
只标注 ≤5 个最可疑帧。不要给修复代码。若堆栈被截断,先说明缺什么。
堆栈:
{{stack}}
适用边界 / 翻车点:边界:框架噪音帧标「忽略」并简述理由。
P04 回归用例先于补丁
场景:准备改代码前
在提出任何代码修改前,先写:
1) 复现步骤(Given/When/Then)
2) 失败时的断言
3) 补丁后应如何绿
格式用测试伪代码。我确认用例后你再给补丁。
缺陷描述:{{bug}}
适用边界 / 翻车点:翻车点:用例依赖未声明的环境变量。
P05 配置/特性开关误伤检查
场景:怀疑配置漂移
检查以下变更是否可能误伤其他环境。输出:影响面表(环境×开关×默认值×风险等级)+ 回滚命令草稿。
禁止改业务逻辑代码;只谈配置与开关。
变更说明:{{change}}
适用边界 / 翻车点:边界:无权限读生产配置时标注假设。
P06 间歇性故障时间线
场景:偶现、难复现
把用户提供的时间戳、版本、流量特征整理成时间线。标出:相关发布、配置变更、依赖告警。
给出「下一轮采集清单」(指标/日志字段)。不要给补丁。
素材:{{timeline_raw}}
适用边界 / 翻车点:翻车点:把相关当因果。
P07 SQL/慢查询只读分析
场景:慢查询或锁等待
只做只读分析:解释计划可能差在哪、缺什么索引假设、如何用 EXPLAIN 验证。
禁止输出破坏性 SQL(DELETE/UPDATE 无 WHERE 等)。给出验证用的 EXPLAIN 模板。
SQL:{{sql}}
适用边界 / 翻车点:边界:方言不明先问。
P08 前后端责任切分
场景:互相甩锅的接口 bug
根据接口契约与现象,输出责任切分表:更可能在前端/后端/网关/数据 的证据各是什么。
每边给出一个最小复现请求(curl 或步骤)。在证据不足时标「待测」。不要先改代码。
契约:{{spec}}
现象:{{symptom}}
适用边界 / 翻车点:翻车点:语气指责同事。
P09 热修与正式修分流
场景:线上要立刻止血
分别给出:A) 热修(最小、可回滚、可接受的技术债)B) 正式修(根因、测试、清理热修)。
标明各自风险。先问我当前是「只要止血」还是「可以停机窗口」。未确认前只给 A/B 大纲不要贴大段 diff。
事故简述:{{incident}}
适用边界 / 翻车点:边界:热修禁止引入新外网依赖。
P10 补丁审阅:专找误改
场景:同事或模型已给出 diff
你是审阅者。只找:无关文件改动、隐藏行为变化、测试缺口、权限扩大。
输出:必须改 | 建议改 | 可忽略。不要重写整个补丁,除非必须改项 ≥3。
diff:{{diff}}
适用边界 / 翻车点:翻车点:风格偏好当成必须改。
P11 依赖升级回归清单
场景:升级库后行为异常
针对 {{lib}} 从 {{from_ver}} 到 {{to_ver}},列出:破坏性变更检查表、最小回归场景、灰度观察指标。
不要直接改业务代码;先给清单。若 changelog 未提供,列出你需要我粘贴的章节。
适用边界 / 翻车点:边界:禁止建议「锁死旧版永不升级」作为唯一方案。
P12 复盘文档骨架
场景:故障已恢复,要写复盘
按模板生成复盘草稿:时间线、影响面、根因(区分直接/促成)、已做修复、后续项(owner/日期)。
语气事实化,禁止甩锅形容词。留白处用 TODO 标出需我填的数据。
素材:{{postmortem_notes}}
适用边界 / 翻车点:翻车点:把未验证假说写成根因。
行业批量:同一骨架换约束块
12 条模板是通用骨架。真正落地时,每个行业都有「绝对不能让模型碰」的地方:电商的价格、支付的回调、SaaS 的租户隔离。我的做法是把行业差异收敛成一个约束块,拼在任意一条 P01–P12 的最前面,骨架不动,只换这一段。
【行业约束块 · 电商】
本系统为电商交易链路。排障时:
- 先要求我提供订单号、用户 ID(脱敏)、发生时间窗,缺一项先问。
- 禁止建议修改价格计算、优惠叠加、库存扣减逻辑;只能指出可疑点并给验证步骤。
- 复现路径需区分「下单→支付→履约」中的哪一段。
【行业约束块 · 支付】
本系统涉及资金。排障时:
- 只做只读对账分析,禁止建议自动重放回调、手工补单或改账。
- 输出必须标注幂等键与渠道流水号的对应关系,缺失就列为待补信息。
- 任何补丁建议须附「资金影响评估」一栏,未评估不得给 diff。
【行业约束块 · 游戏】
本系统为客户端 + 服务端架构。排障时:
- 先按客户端版本、渠道包、服务器分区分桶,再判断是否同一问题。
- 热更相关问题先确认资源版本号,禁止建议全量回滚作为第一步。
【行业约束块 · IoT】
本系统包含设备固件与云端。排障时:
- 先区分固件侧、网络侧、云端侧,各列一条最小验证步骤。
- 必须标出设备批次与固件版本;禁止建议远程批量重刷固件。
【行业约束块 · SaaS 多租户】
本系统为多租户。排障时:
- 先确认租户隔离键与受影响租户范围,未确认前不给补丁。
- 禁止给出跨租户查询或无租户条件的 SQL;示例数据一律脱敏。
用法:值班手册里按业务线各存一份约束块,拼接顺序固定为「行业约束块 → P 模板 → 材料」。新业务线接入时,只需要回答三个问题:哪些数据不能动、复现需要哪些标识、补丁上线前必须过谁。答案写进约束块,就是你们自己的行业批量版本。
组合打法与我真实用过的顺序
一次典型排障我会这样串:P01 出复现路径 → 用户补日志 → P03 标可疑帧 → P04 写回归用例 → 我确认 → 再让模型出最小 diff → P10 审阅。间歇性故障插入 P06;要止血时并行开 P09 的 A 方案。
同一条长提示词塞进「又要复现又要补丁又要复盘」,模型会跳步。拆开后,你更容易在某一步喊停。喊停的权利,比漂亮的最终答案重要。
今晚接到仓库:30 分钟落地

不谈「提示词的未来」,只做三件事、跑一次、定一条验收线。
1. 安装(10 分钟):放三个文件。
- 系统层:用 Cursor 的放
.cursor/rules/debug-repro-first.mdc(alwaysApply: true);用 Claude Code 的写进仓库根目录CLAUDE.md;团队 Bot 就贴进它的系统提示。三处内容相同,只放一句硬约束:「排障先给复现路径与缺失信息;我确认复现后才给最小补丁;信息不足先提问;未经确认不改配置、不推生产。」No把 12 条全塞进去。 - 材料槽:
docs/oncall/debug-slot.md,四个字段:环境/日志或堆栈/已尝试/期望行为,末行写「有日志选 P01,有堆栈选 P03」。 - PR 模板:
.github/pull_request_template.md加两个必填标题「复现路径」「回归用例」,再加一个勾选项「已用 P10 做误改审阅」。
2. 跑通(10 分钟):拿旧故障回放,别等新事故。用 git log --since=30.days --grep=fix --oneline 挑一条上月已修好的缺陷,把当时的日志填进材料槽,套 P01 发给模型。通过标准只有一个:第一轮回复里没有 diff,只有复现路径和「还缺什么」。如果第一轮就出补丁,说明系统层没生效,回到第 1 步检查文件位置或规则是否被加载。
3. 配置(5 分钟):按业务线拼约束块。把上文对应行业的约束块存成 docs/oncall/constraints-电商.md 这类文件,拼接顺序固定为「约束块 → P 模板 → 材料槽」。只改约束块,不动 P 模板本体,否则下次升级模板时会合并冲突。
4. 翻车(5 分钟看一遍):
- 模型还是直接给补丁:多半是规则文件没被加载(Cursor 规则没设
alwaysApply、Bot 系统提示被会话覆盖),不是提示词不够长。 - 模型反复追问、永远不给补丁:你没回「确认复现」这四个字,P01 第 2 步的触发词要和团队口头习惯一致。
- 模型编造文件路径:材料槽里没给仓库结构,补一段
tree -L 2输出即可。 - PR 模板被大家写「同上」:审阅者要真打回一次,规则才立得住。
5. 验收:下一周值班里,至少 3 次故障按「复现 → 用例 → 最小 diff」走完,且 PR 里两个必填段都有实际内容;同时统计「直接开改却改错」的次数,应低于上一周。降不下来,先查系统层有没有生效,而不是再写更长的提示词。
短局限:提示词不替代权限与变更窗口;没有可观测性时模板也在猜。若你只带走一句:先复现路径,再给补丁;信息不够就问。


评论列表 (0条):
加载更多评论 Cargando...