Skip to content

保留、删除、改进:证据与风险 ​

产品拆解的结论不应只有“新增功能”。现有机制可能应保留、删除、改进,也可能暂时不改。四种决策都要绑定任务结果、证据强度、受影响方和风险;个人偏好不能替代产品判断。

一、四种决策分别意味着什么 ​

保留 ​

现有机制对明确任务有可复核价值,在当前边界内风险和成本可接受。保留不是永久不变,应写适用范围、继续监控的指标和复审条件。

删除 ​

停止提供入口、行为、格式或依赖。删除可能影响存量数据、自动化脚本、文档、权限、历史链接和用户流程,因此它是迁移项目,不是隐藏按钮。

改进 ​

任务价值仍成立,但当前机制在结果、成本、可靠性、可访问性或风险上有证据支持的问题。改进必须保留基线,并说明改变哪条因果链。

暂时不改 ​

证据不足、风险过高、收益低于机会成本,或依赖条件尚未满足。暂时不改不是逃避,前提是记录缺少什么证据、何时复审以及什么变化会触发行动。

二、先把事实、判断和目标拆开 ​

每项建议都应至少包含三层:

  1. 观察事实:日志、任务回放、支持记录、官方合同或依赖扫描显示了什么;
  2. 分析推断:这些事实可能意味着什么,并注明边界;
  3. 决策假设:采取动作后预计改变什么,可被什么结果证伪。

例如:

text
事实:过去 90 天,大文件同步导出的超时率为 18%。
推断:同步请求的处理时间超过网关边界,是失败的重要原因。
假设:改为异步任务并显示进度后,成功率会上升且重复提交下降。
证伪:灰度组成功率未改善,或等待时长、支持量显著恶化。

不能从“调用量低”直接推出删除。低频功能可能服务年度高价值任务、合规导出、灾难恢复或少数关键角色。

三、统一决策卡 ​

json
{
  "decision": "improve",
  "object": "大文件导出",
  "observed_on": "2026-07-17",
  "target_task": "管理员导出完整交易记录并完成月度核对",
  "facts": [
    "过去90天同步导出超时率为18%",
    "超时任务中有31%在10分钟内重复提交"
  ],
  "inference": "等待状态不透明和同步处理共同增加失败与重复提交",
  "hypothesis": "异步任务、进度与幂等提交会提高成功率",
  "primary_metric": "24小时内成功导出率",
  "guardrails": ["导出数据完整率", "未授权访问数", "支持工单率"],
  "rollback": "完整率下降或严重权限事件立即关闭新路径",
  "review_on": "2026-08-17"
}

决策卡必须链接原始查询、测试记录和负责人。数字没有时间窗、分母和样本范围时,不能作为可复核事实。

四、证据强度决定下一步 ​

证据等级例子可支持的动作
弱单个反馈、个人体验、一次截图建立问题清单、补证据
中多次任务回放、支持主题、分段日志原型或小流量可逆实验
强稳定行为数据、受控比较、依赖清单、重复验证分阶段发布或迁移
强且高风险强证据但涉及安全、法律、关键流程专项评审、双轨和严格回滚

证据强不等于风险低。删除一个已知不安全机制可能价值明确,但仍需处理依赖和迁移;法律或安全紧急情况也可能缩短通知期,此时应明确例外依据和补救措施。

五、保留的判断方法 ​

保留项要证明“当前机制值得继续存在”,而不是“没人提意见”。至少检查:

  • 它服务哪个角色和任务;
  • 使用后是否得到正确结果;
  • 是否存在低频但关键的周期性使用;
  • 它是否是其他流程、接口或合规要求的依赖;
  • 当前成本和负面影响是否可接受;
  • 替代方案是否真的覆盖同一边界;
  • 哪个指标恶化后需要重新评估。

保留也可以伴随维护动作,例如补充文档、增加监控或冻结新能力。不能把“保留”理解为不投入任何运行成本。

六、删除是完整生命周期 ​

1. 发现依赖 ​

检查页面入口、API 调用、脚本、数据字段、定时任务、权限策略、帮助文档、合同和人工流程。依赖扫描要覆盖内部和外部使用方。

2. 提供替代与迁移 ​

说明新入口或新格式如何完成原任务,给出字段映射、示例、迁移工具和验证方法。没有等价替代时,要明确哪些能力将消失。

3. 公告与观察 ​

设置公告日、停止新增日、只读期和关闭日。为活跃调用方提供可定位通知;仅发布博客通常不能证明依赖方已收到。

4. 双轨与回退 ​

高风险迁移可让旧新路径并行一段时间,对比结果并保留回退。双轨会产生额外成本和数据一致性问题,因此需要明确期限。

5. 关闭与清理 ​

删除路由、凭证、队列、存储、监控、文档和计费资源;按保留政策处理历史数据,并验证没有孤立依赖。GOV.UK 的应用退役清单把取消发布、移除依赖测试、DNS 和基础设施列为实际步骤,说明下线远超过隐藏界面。

七、识别破坏性变化 ​

以下变化可能破坏集成:

  • 删除操作、参数或响应字段;
  • 重命名字段或改变类型;
  • 将可选参数改为必填;
  • 删除枚举值或增加更严格验证;
  • 改变认证、授权或错误合同;
  • 改变默认行为,使旧请求产生不同结果。

GitHub REST API 文档将这类变化放入新 API 版本并要求升级后测试;其具体支持期限属于 GitHub 当前政策,不能直接当作所有产品都应采用的期限。可借鉴的原则是版本隔离、提前通知、迁移说明和兼容性测试。

新增可选字段通常是加法变化,但客户端若错误假设字段集合固定,仍可能失败。因此提供方要维持合同,使用方也要测试对未知字段和顺序变化的容忍度。

八、改进必须有因果链和回滚 ​

改进方案至少写清:

text
问题事实 → 机制判断 → 具体改动 → 用户行为变化
→ 任务结果指标 → 产品目标 → 守护指标

示例:

text
同步导出超时且重复提交
→ 长任务缺少持久状态和进度
→ 改成异步任务、幂等键、进度与失败原因
→ 用户无需保持页面且减少重复点击
→ 24小时成功导出率提高
→ 月度核对任务完成率提高
守护:完整率、权限事件、等待时长、支持工单率

上线前保存当前基线,明确灰度单位、样本窗口、停止条件和旧路径保留时间。只看主指标可能把风险转移给少数用户或后续人工流程。

九、完整案例:数据导出 ​

1. 任务与输入 ​

目标任务:管理员导出交易数据,用于月度核对和外部归档。候选对象是 CSV、旧 XML 和大文件同步处理方式。

教学场景证据如下,数字不代表任何真实产品:

  • CSV:过去 90 天有 2,400 个活跃组织使用,任务成功率 98.7%;
  • XML:过去 90 天有 12 个调用方,其中 8 个来自同一旧集成;
  • 依赖扫描:XML 仍被 3 个外部组织和 1 个内部归档任务调用;
  • 大文件同步导出:1GB 以上任务超时率 18%;
  • 支持记录:导出相关工单中,42% 询问“是否仍在处理”;
  • 数据核对:当前成功文件的字段完整率为 99.98%;
  • 风险边界:导出必须遵守租户权限,不能跨组织泄露数据。

2. 保留 CSV ​

事实:CSV 服务大量活跃组织,成功率较高,并被月度核对流程持续使用。

决策:保留格式、字段合同与权限模型,同时增加字段版本说明。

风险:字段顺序或语义的无通知变化会破坏自动处理;大文件问题仍未解决。

验证:持续监控成功率、字段完整率、使用组织数和解析失败;每季度复审。保留结论只适用于当前任务和字段合同。

3. 分阶段删除旧 XML ​

事实:使用量低但仍有明确依赖,因此不能立即关闭。

决策:停止新建 XML 集成,向 4 个依赖方发送可定位通知,提供 XML 到 CSV 字段映射和测试文件;完成迁移验证后进入只读和关闭阶段。

text
T0:发布弃用公告,冻结新接入
T0 + 30 天:逐一确认依赖方负责人和迁移计划
T0 + 60 天:提供双轨输出,对比字段与记录数
T0 + 90 天:停止常规 XML 生成,保留紧急回退
T0 + 120 天:满足退出条件后关闭并清理资源

时间仅为场景计划,应根据合同、风险和真实迁移能力调整。

关闭条件:连续两个核对周期没有未迁移调用;字段、记录数和权限范围一致;内部归档已切换;支持和回退责任明确。

失败分支:若外部依赖方在双轨中发现 CSV 缺失关键语义,暂停关闭,补齐合同或明确能力损失;不能因已公布日期而忽略数据损坏。

4. 改进大文件导出 ​

方案:请求提交后返回任务 ID;后台异步生成;页面显示排队、处理中、成功、失败和过期;重复提交使用幂等键;完成后通知;失败提供原因和安全重试。

主指标:24 小时内成功导出率。

守护指标:字段完整率不得低于基线;跨租户访问事件为零;P95 完成时间不显著恶化;支持工单率不上升。

灰度:先对内部账号和 5% 低风险组织开放,再扩大到 25%、50% 和全部。每一阶段必须覆盖取消、权限变更、链接过期和任务重复。

回滚:若发生严重权限事件立即关闭新路径;若完整率下降超过预设阈值,停止扩量并保留旧路径;已提交任务要有明确处理或取消策略。

5. 暂时不新增 PDF 导出 ​

当前只有零散请求,且月度核对需要结构化数据。先记录需求来源和实际任务,不直接把“有人提过”转成开发结论。如果后续出现稳定使用场景、合规格式要求或手工转换成本,则重新评估。

十、如何验证三类决策 ​

保留项 ​

验证使用是否与正确结果相关,监控成本和风险,并设置复审触发器。沉默用户不是正向证据。

删除项 ​

在关闭前核对活跃调用、依赖负责人、迁移结果、数据导出、通知送达和回退演练;关闭后检查错误率、支持量、遗留资源和费用。

改进项 ​

比较相同人群和时间窗的任务结果,同时看守护指标。若实验无法隔离,可用分阶段发布、任务回放和前后分段数据,但要说明混杂因素。

暂时不改项 ​

验证机会成本和证据缺口是否仍存在。到期不复审会把“暂时”变成无依据的永久搁置。

十一、常见错误 ​

  • 因自己不用就建议删除,忽略其他角色和周期性任务;
  • 把低调用量当低价值,不看结果和风险;
  • 只删除入口,不处理 API、数据、文档和计费资源;
  • 用“体验更好”描述改进,不写基线与可证伪指标;
  • 只看总量,掩盖关键组织或无障碍用户受损;
  • 公告已发布就认为迁移完成,没有验证依赖方状态;
  • 为保留旧路径无限延长双轨,累积更多复杂度;
  • 没有证据时伪造确定结论,而不是明确假设。

十二、完成检查与练习 ​

每项决策应能回答:

  • 对象、目标角色和任务是什么;
  • 事实来自哪个时间窗、分母和原始证据;
  • 推断和假设分别是什么;
  • 谁受益,谁可能受损;
  • 依赖、数据、权限和历史合同如何处理;
  • 主指标、守护指标和基线是什么;
  • 如何灰度、停止、回滚和复审;
  • 哪个条件变化后,当前决策不再成立。

练习:选择一个已有功能,分别提出保留、删除、改进和暂时不改各一项。为删除项画出迁移时间线,为改进项写灰度与回滚,为保留项设置复审触发器。完成标准是每个动作都有事实、推断、风险、验证和失败分支,不依赖个人审美判断。

来源 ​

从前端走向软件产品工程的长期路线图。