tsl-playbook/.agents/performance.md

性能（Performance）

本文件定义代理在做性能相关改动时的准则与检查项。

1. 目标与度量

• 明确性能目标：延迟、吞吐、内存、CPU、I/O 等。
• 没有指标时不要盲目优化；先补充测量或基准。

2. 处理流程

1. 先定位瓶颈（profile/trace/log）。
2. 再提出最小化改动方案。
3. 最后用数据验证收益与副作用。

3. 优化准则

• 优先消除算法/结构性问题，再考虑微优化。
• 避免引入复杂度换取小收益。
• 性能优化不应牺牲可读性；必要时加注释说明权衡。

4. 常见风险

• 避免重复计算、无界缓存、隐式复制。
• 注意热路径中的分配与 I/O。
• 并发优化要考虑正确性与可测试性。

5. 验证

• 提供优化前后可复现的对比数据（基准、采样结果或压测报告）。
• 若无测试体系，至少提供最小可运行的复现脚本/步骤。