一份能过预审的产品缺陷报告长什么样：三段式模板 + 证据清单

先说结论

这一周我在云声建议平台上提了 6 条建议，结果分布是这样的：

被采纳的和被打回的，区别不在问题大小，而在有没有把三件事写清楚：在哪一步出的问题、你期望它变成什么样、这事儿影响谁。第一条我写的只有一句"界面有点卡，建议优化"，直接进"其他"；改成三段式之后，同样的平台、同样的人、同样的时间，连过两条并在两天内被采纳。

下面是我最后定型用的模板和几个具体写法。

三段式到底是什么

不是"分三段写"，而是三段各自回答一个不同的问题，缺一段就会被打回：

第一段：场景描述 —— 回答"怎么复现"

必须能让审核的人按你写的步骤走一遍，走到同一个地方看到同一个现象。要素清单：

• 时间：2026-10-30 08:40 左右
• 入口：完整路径，别写"那个页面"，写 developer.huaweicloud.com/devspace?utm_source=officeagent
• 控件名：能拿到 id 或文案就给，例如「体验版卡片上的『立即进入』按钮」
• 你做了什么：点击顺序，1/2/3 写出来
• 看到什么：报错原文、页面提示、HTTP 状态码，原样粘贴，不要转述

反例和正例放在一起看最明显：

❌ 反例：云声建议提交按钮点了没反应，希望能修复一下。

✅ 正例：在 bbs.huaweicloud.com/suggestion/new，窗口宽度 988px 时，关联产品的 .product-item 面板与 .tab-item 覆盖在 #submit-btn 之上；document.elementFromPoint(x,y) 返回的不是按钮本身。点击提交无任何提示、无网络请求。窗口拉宽到 1600px 后正常。

后者审核的人可以自己拉窗口试一次，三分钟就能确认。前者只能靠猜。

第二段：期望结果 —— 回答"改成什么样"

这段最容易写成空话。"希望优化一下"不是期望结果，期望结果要具体到交互层面，最好直接给出你希望看到的文案或行为：

❌ 反例：建议优化标签功能，提升用户体验。

✅ 正例：标签选择后立即在输入框区域渲染可删除的 chip；输入时下拉出现候选标签，回车选中，退格删除；提交校验失败时给出明确文案（如"请至少选择 1 个标签"）并把焦点滚到标签区域，而不是静默 return false。

一条建议最多写 3-4 个期望点。写 10 条反而没人看得下去。

第三段：影响范围 —— 回答"为什么值得改"

这段决定优先级。不要写"影响体验"，要写清楚"谁、在什么场景下、多付了什么成本"：

• 能量化就量化："长文平均 1500–3000 字，踩一次就是半小时白写"
• 能说清链路就说链路："标签选不上 → 文章进不了对应技术分类 → 一发布就少了主要曝光入口"
• 能指向次级影响更好："反复尝试会新建多个体验版容器，占用平台资源"

我最长的那条建议，影响范围写了三类人：写长文的作者、愿意答题的用户、需要"多少问题超过 24 小时无人回复"这类指标的运营。

证据比形容词管用

审核是人工看，但有证据的单子处理速度快一个量级。我现在的固定清单：

截图有用但别指望它：审核的人不一定放大看，文字里能复述的现象才可靠。

类型选错，写得再好也白搭

平台把建议分成「功能建议 / 用户体验 / 产品缺陷」三类，实测类型会影响处理路径：

• 你把一个明确的 bug（点了没反应、计分不对）写成"功能建议"，审核会按需求排期，等不到修复；
• 把一个"希望能批量导出"写在"产品缺陷"里，会被判为提错类型，直接进"其他"。

我的判断标准：现有功能按设计正常工作，只是不好用 → 用户体验；现有功能偏离了它自己的说明 → 产品缺陷；现在压根没有这个功能 → 功能建议。

举个真实例子：成长中心有一张「每日体验 AI DevSpace」的卡片，我连续两天按它说的步骤做了，第一天计分、第二天不计分，页面上也看不到判定条件。这条我提的是产品缺陷，不是用户体验——因为卡片的文案承诺了"每日"可以拿分，实际行为与文案不符，这是偏差，不是"不够顺手"。

一个可以直接抄的结构

场景描述：
<日期时间>，在 <完整入口>，<控件名/位置>。
操作步骤：1) ... 2) ... 3) ...
现象：<报错原文 / 页面提示 / 状态码>。

期望结果：
1) <具体交互>
2) <具体文案或提示>
3) <失败时的兜底行为>

影响范围：
<谁受影响> + <在多长的时间尺度上> + <额外成本是多少> + <次级影响>

我自己用这个结构写过的 4 条里，2 条预审通过、1 条已采纳。而被"其他"打回的那两条，回头再看，问题都出在第一段——它们描述的是感受，不是现象。

最后两个小习惯

• 一天一条，宁缺毋滥。同一天连提三条同质建议，后面两条大概率被合并或忽略；把一个问题写透，比散着提五条值钱。
• 提完自己读一遍：假设你是审核的人，能不能在不问任何问题的情况下复现它？不能就补，别急着提交。