retro

用户要求复盘。目标是改进 agent 的环境——引导文件、检查链、工具、信息通路——让后续运行更顺，而不是评价这一次的结果。

步骤

1. 读 writing-for-agents；改动落点（AGENTS.md、skill、项目 docs）和写法都按它。
2. 读会话一手记录。Pi 会话按工作目录存于 ~/.pi/agent/sessions/<目录路径编码>/*.jsonl，用户未指定则取当前会话。完成标准：每个工具调用与其结果都已过目，而不是只看对话摘要。查会话与用量的统计先用 session-data，不现写脚本扫原始文件。

3. 按下列类别逐类核对，找候选。每个候选附会话中的证据（发生了什么、耗了多少轮）。

   • 导航：agent 找一个文件或事实花了多轮。是否缺一条 AGENTS.md 里的指针，或指针措辞太弱没触发？
   • 自动检查：agent 犯的错本可被 lint hook、类型检查或接缝上的测试捕获。先读仓库已有的检查入口（lint/check 脚本、提交钩子、CI 工作流）：已有但没接上或已坏的检查，候选是接上或修好它，不另造。按 better-test 判断值不值得加。同类纠正出现两次，按 架构消除 → 类型 → lint（报错写明该用什么）→ 测试 → 文档 的顺序处理；机械型违规（固定写法、禁用 API、导入形态、文件位置）一律做成检查，不写成规则；新检查要在一个真实历史错误上证明会变红。仓库没有提交钩子也没有 CI，本身就是一条发现。
   • 审查漏判：审查放过了本该拦下的错。机械型的归入自动检查；只能靠判断的，写进审查者会读的项目约定，并附这次漏掉的实例。
   • 引导蔓延：AGENTS.md 或 skill 里有 agent 默认就会做的无操作指令、已过时的沉积物、同一规则的第二份副本。候选是删除或收口到单一事实源，不是补写。
   • 工具经济：昂贵或高噪声的工具调用——大文件整读、重复搜索、本该委派给子代理的长任务。
   • 信息通路：agent 需要却拿不到的信息——dev server 日志、第三方服务只读访问、被忽略的环境事实。
4. 按严重程度排序呈现候选，每条给出建议改动与代价；等用户挑选后再动手。