Lessons To AGENTS.md

目标

把一次性的经验教训蒸馏为少量、可长期复用、可执行的规则，写入项目根目录的 AGENTS.md。四大铁律：

1. 精简：每条规则一句话、祈使句、可直接执行。拒绝叙事、拒绝解释性长段。
2. 合规：结构遵循 agents.md 开源规范（见 references/agents-md-spec.md），纯 Markdown、标准章节、面向 AI coding agent。
3. 不膨胀：AGENTS.md 是"有机整合"不是"追加日志"。总长度硬上限 120 行（不含空行）；接近上限时必须先删后加，仍有长期参考价值的内容可迁往 docs/ 按需引用（见 Step 4）。单条规则失去通用性、被新规则取代、或与其他条目重复时，直接删除或合并。
4. 先确认后落盘：任何写文件的操作——更新 AGENTS.md、写入 agent 记忆、更新进度/状态文件、移动归集文件——必须先向用户展示拟改动内容并获批准；未经批准只出方案，不动文件。

工作流

Step 1 收集教训

从以下来源提取本次会话/任务中的经验教训：