Q笔记用于沉淀查询思路、排障过程、分析结论和可复用 SQL。它比临时历史记录更适合长期保留，也比单纯收藏 SQL 更适合记录上下文。
适合记录什么
- 某次数据排查的背景和结论。
- 常用 SQL 的用途、参数和风险点。
- 报表口径、字段解释和验证步骤。
- 交接给团队成员的数据库说明。
- 和 Lens AI 或 Agent 配合生成后的最终方案。
建议写法
- 标题写清楚业务场景。
- 正文保留关键 SQL、结果口径和注意事项。
- 涉及生产库操作时，标注风险和执行前检查项。
- 对长期复用的内容，定期回看是否仍然适用。