文案应帮助用户完成下一步，让错误提示指向具体位置，不让内部分类挡住日常工作

文案应帮助用户完成下一步

一个功能的效果应放在具体使用流程中检查。

交互评审需要包含首次使用与偶尔使用的情境。

让错误提示指向具体位置

抽象是否有效，可以看新场景接入时需要知道多少旧场景的细节。若每次增加调用者都必须再添一个特殊开关，原有边界可能并未抓住共同规则。重构时可以保留真实差异，让相似代码暂时并存，避免为了消除表面重复而创造更难理解的统一入口。

默认选项需要容易理解，也应允许合理调整。

导出范围最好在操作发生之前清楚可见。

不让内部分类挡住日常工作

性能测试中的数据分布应接近要检验的问题。所有对象大小相同、访问均匀的样例，可能看不到热点与大对象造成的差异。可以明确每种负载代表哪类情境，让结果解释有边界，也避免把一次理想条件下的速度直接当成所有真实使用方式都能达到的表现。

同一行为的命名需要保持稳定的使用预期。

历史记录应帮助理解变化，而不仅显示有人操作。