Ajiang Ablation

---
name: ajiang-ablation
description: 做消融实验：每次移除或替换一个机制，对比效果、成本和失败场景，判断该保留、删除还是合并。
license: MIT
---

# 消融实验

不要从“架构看起来乱”直接推导全面重写。用实验定位无收益的复杂度，同时保留有价值的保障。

## 确定基线与比较指标

写清原用户任务、行为/数据契约与必须保留的失败防护。选择代表任务的正常路径及相关错误、恢复、边界或低频场景。

采集与当前问题有关的基线：耗时、模型调用/成本、内存、依赖、重复实现维护点、故障或误阻断。代码行数用于寻找候选，不独自作为质量指标。

## 一次只改变一个机制

优先查：同一规则的多份实现、同一数据的多份来源、昂贵复核层、保留的旧入口、没有实际消费者的配置、反复转换的数据、令真实测试无法覆盖的依赖关系。

在隔离工作副本或可回滚实验中，一次移除、绕开或替换一个机制，重跑同一输入与验收。记录实验改变了什么、哪些结果维持、哪些结果退化、成本如何变化。任务只要求评估时，实验不能变成对正式源码的永久重构。

安全、数据完整性与恢复护栏必须有对应失败或攻击场景。正常样本没有差异，不足以证明这些护栏冗余。难以观察收益的候选标成待验证，不凭名称删掉。

## 根据结果决定取舍

| 候选机制 | 原责任 | 实验变化 | 行为证据 | 成本变化 | 结论 |
|---|---|---|---|---|---|

结论可为保留、删除、合并、替换或待验证。合并重复实现前查平台、接口和行为差异；统一代码不能靠删掉必要差异实现。

选择能解决当前用户问题的最小组合，说明收益与迁移代价。不要把每个已有问题都纳入，也不要为了减少现有层数再引入一套没有被需要的新框架。

## 落地与退役

任务已经授权实施时继续完成具体改造；仅要求分析时交付可审查方案。修改触及正式数据/迁移或外部操作时遵循当前授权，不从“重构”推导额外权限。

新路径上线后检查旧函数、路由/注册、配置、测试、依赖与公开文档。没有消费者的旧路径按证据退役；兼容入口暂时保留时说明责任和可验证的退役条件，避免永久双轨。

重跑基线任务及相关回归，测量实际成本。必要的不变量由回归测试守住；不编写只匹配目录结构、命名或实现文本的测试。

## 交付

说明保留了什么用户结果、实验支持删掉什么、成本如何变化、旧路径是否退役。没有测量的收益不写为数字。一次任务成功不能宣称所有历史行为等价；未覆盖的平台与低频条件明确列出。

候选较多或需要多轮实验时，可按 [消融实验记录](assets/task-record.md) 保存基线、单变量变化、取舍和退役证据。