retro

用户要求进行一次回顾。你正在建议改进编码 Agent 的环境，以提升未来任务的表现。

步骤

1. 阅读 write-skills，了解写作风格指南。

2. 阅读用户指定会话的主要来源。这可能意味着要搜索本机上的会话日志。如果用户未指定会话，则默认为当前会话。

3. 在以下类别中寻找可改进之处。

• 导航：Agent 是否能轻松找到合适的文件？文件之间是否存在隐藏依赖？添加导航指引是否会更方便？适用情况：会话花了很长时间才找到某项信息。
• 自动化检查：是否有自动化检查可以发现 Agent 所犯的错误？例如代码检查、类型检查、测试、文件系统检查器等。首先阅读仓库自身的检查命令（其 package.json／构建工具中的 lint／check 脚本及其 CI 工作流），因此，发现一个已存在但未接入或悄然失效的检查，才是问题所在，而不是重新发明一个。如果仓库完全没有防护机制（没有运行其代码检查／类型检查／测试命令的预提交钩子，也没有 CI 任务），这本身就是一个问题：没有代码检查的仓库意味着持续错失改进机会，并非无关紧要的默认状态。适用情况：Agent 犯了自动化检查本可发现的错误，或仓库完全没有防护机制。
• 编码规范：是否应要求审查 Agent 执行一条新规则？是否应删除或澄清现有规则？先对违规分类：机械性违规（固定语法模式、禁用 API、导入格式、文件位置规则）必须使用确定性检查：在仓库自己的检查工具中添加自定义规则、新增预提交钩子或新增 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：将 Skills 用于文档（其说明会进入 Agent 的上下文窗口），或用于用户调用的命令。请遵循 write-skills 中的建议。