retro

用户要求进行回顾。你要针对编码 Agent 的环境提出改进建议，以提升未来的运行效果。

步骤

1. 加载 writing-for-agents 技能（阅读其 SKILL.md），了解写作风格指南。

2. 阅读用户指定会话的主要来源。这可能意味着要搜索本机上的会话日志——使用 pi-session-search 技能（对 ~/.pi/agent/sessions 中的 JSONL 进行 UTF-8 安全查询；取代临时使用 grep/python 的单行命令）。如果用户没有指定会话，则默认为当前会话。

3. 从以下类别中寻找改进机会。

• 导航：Agent 查找正确文件的难度如何？文件之间是否存在隐藏依赖？添加导航指引是否会更方便？_适用于_会话花了很长时间才找到某条信息的情况。
• 自动化检查：是否有自动化检查可以捕获 Agent 犯下的错误？例如 lint、类型检查、测试、文件系统 lint。先阅读仓库自身的检查命令（其 package.json/构建工具中的 lint/check 脚本、CI 工作流），以便发现已存在却未接入或失效的检查，而不是重新发明。若仓库没有防护措施（没有运行 lint、类型检查或测试命令的 pre-commit 钩子，也没有 CI 任务），这本身就是一项发现：没有 lint 的仓库错失了持续改进的机会，并非中立的默认状态。适用于 Agent 犯下了自动化检查本可捕获的错误，或仓库完全没有防护措施的情况。
• 编码规范：是否应为审查 Agent添加一条新规则？是否应删除或澄清现有规则？先对违规进行分类：机械性违规（固定语法模式、禁用 API、导入格式、文件位置规则）必须通过确定性检查处理：在仓库自己的 linter 中添加自定义规则、新增 pre-commit 钩子或 CI 任务，具体选用哪种，取决于仓库使用的语言和现有防护措施，以成本最低者为准。默认优先构建检查，而不是编写规则。只有真正需要判断的事项（跨文件一致性、“符合周边风格”之类任何防护措施都无法替代的内容）才应写入 CODING_STANDARDS.md。适用于 审查 Agent 未能发现错误的情况。
• 全局 AGENTS.md：是否有应移至编码规范（或自动化检查）的指导说明？适用于 仓库内或用户全局范围内的 AGENTS.md 文件特别庞大的情况。
• 工具开销：Agent 是否调用了开销较大的工具，且可以简化？是否有特别耗费令牌的自定义工具（CLI、MCP）？适用于 Agent 调用了开销较大的工具的情况。
• 无效指令：检查指导文件中是否有未能改变 Agent 行为的指令。适用于 指导文件庞大且难以管理的情况。
• 信息获取：是否有机会增加 Agent 获取信息的渠道？例如提供开发服务器日志、对第三方服务的只读访问权限。适用于 Agent 无法获取关键信息的情况。

4. 按严重程度排序，向用户列出这些候选项。

参考

实现与审查

请记住，所有工作都要经过两个阶段：实现和审查。实现 Agent 承受的上下文压力最大，因为它们负责探索、编写代码和调试故障。

审查 Agent 承受的上下文压力最小——它收到的是差异，因此无需探索。它通常也不需要编写代码或调试。

因此，编码规范应由审查 Agent 负责执行，而不是由实现 Agent 负责。

文件

你可以访问仓库中的若干文件：

• CLAUDE.md/AGENTS.md：这些文件会被载入此仓库中任何 Agent 的上下文窗口。应极少使用，通常仅用于指向其他文件的导航指引。
• CODING_STANDARDS.md：该文件在评审时阅读，而非实现时阅读。若该标准文件超过 1,000 行，请添加指向文档文件夹的导航指引。
• 文档：将文档用作参考文件，由其他文件指向。编写新文档前，请先查找已有文档。
• Skills：将 Skill 用于文档（因为其描述会进入 Agent 的上下文窗口），或用于用户调用的命令。请遵循 writing-for-agents Skill 中的建议。