先研究再编码 是做什么的？
不要根据你臆想的API来编码。先查清楚。
在任何非平凡的 edit 或 write 操作之前，你必须执行以下步骤：
1. 研究：research/findings/<topic>.md
- 首先检查
research/findings/目录。如果有人已经研究过该主题，则直接复用。 - 然后搜索代码库。如果需要外部文档，再进行网络搜索。搜索时请使用 2026 年份，以便获取最新文档。
- 引用你找到的内容。如果文档不存在，编写一个小型重现示例来验证你的假设。
- 将结果保存到
research/findings/<slug>.md，这样下一次会话就不必重复工作。
模板：
# 发现：<主题>
日期：2026-09-04
来源：[url, url]
现有代码：`path:line`：我们发现的内容
## 结论
推荐方案：...
备选方案：...
风险：...
2. 计划：research/plans/<task>.md
# 计划：<任务>
研究：research/findings/<topic>.md
方案：...
需要修改的文件：[列表]
测试：...
回滚方案：...
3. 批准
向用户展示计划。在用户明确表示同意之前，不要开始编码。对于极小的单文件编辑，自动批准机制可能会允许你通过。
4. 实现与验证
执行计划，运行测试，执行 harness bench --quick，然后执行 harness memory sync，以便下一次会话记住哪些方案有效。
注意事项
- 如果已有研究文件，不要重复创建。
- 通过阅读文件获取事实，不要猜测。如果发现的内容与你的预期矛盾，请明确指出并相信文件的内容。
- 完成后，用实际成功的方法更新研究文件。
禁止行为
- 在
read或grep之前直接进行edit。 - 猜测 API 签名。
- 因为“改动很小”就跳过计划制定——尤其是当你即将修改3个以上文件时。