用户要求进行一次回顾。你将提出改进编码代理运行环境的建议,以优化未来的执行过程。
步骤
-
调用
writing-for-agents技能的 Skill 工具获取写作风格指南。 -
读取用户指定的会话的主要日志来源。这可能意味着在本机搜索会话日志。如果用户未指定会话,则默认使用当前会话。
-
从以下类别中寻找可改进项。
- 导航:代理找到正确文件的难易程度如何?文件间是否存在隐藏的依赖关系?添加一个导航指针是否会更容易?适用场景:会话花费了很长时间才找到某个信息。
- 自动化检查:是否存在可以捕获代理所犯错误的自动化检查?如 linting、类型检查、测试、文件系统 linter?首先阅读仓库自身的检查命令(其
package.json/构建工具中的lint/check脚本、CI 工作流),因此如果一个已经存在但未连接或静默失效的检查才是发现,而不是重新发明轮子。一个没有护栏(没有 pre-commit 钩子,没有运行 lint/类型检查/测试命令的 CI 作业)的仓库本身就是一个发现:未 lint 的仓库是一个长期错失的机会,而不是中性的默认状态。适用场景:代理犯了一个本可以通过自动化检查捕获的错误,或者仓库完全没有护栏。 - 编码标准:审查代理是否应被赋予一条新的规则来执行?现有规则是否应被移除或澄清?首先对违规进行分类:机械性违规(固定的语法模式、禁止使用的 API、导入形状、文件位置规则)应获得确定性检查,无需多言:在仓库自身的 linter 中添加自定义规则、新的 pre-commit 钩子或新的 CI 作业,根据仓库语言和现有护栏选择最经济的方式。默认优先构建检查而非编写规则。将
CODING_STANDARDS.md留给真正的判断性问题(跨文件一致性、“与周围风格匹配”、任何护栏永远无法替代的方面)。适用场景:审查代理未能捕获某个错误。 - 全局 AGENTS.md:是否存在应该移至编码标准(或自动化检查)中的引导指令?适用场景:仓库或用户全局作用域中的 AGENTS.md 文件特别庞大。
- 工具经济性:代理是否调用了昂贵但可以简化的工具?是否存在特别消耗令牌的自定义工具(CLI、MCP)?适用场景:代理调用了昂贵的工具。
- 无操作指令:查找引导文件中不改变代理行为的指令。适用场景:引导文件庞大且难以管理。
- 信息访问:寻找增加代理信息访问的机会。例如:打开开发服务器日志,以只读方式访问第三方服务。适用场景:代理未能获取关键信息。
- 按严重程度向用户展示这些可改进项。
参考
实现 vs 审查
请记住,所有工作都经历两个阶段:实现和审查。实现代理承受最大的上下文压力。他们负责探索、编写代码和调试失败。
审查代理的上下文压力最小——它接收一个 diff,因此无需探索。它通常不需要编写代码或调试。
这意味着审查代理应负责施加编码标准,而不是实现代理。
文件
您有权访问仓库中的几个文件:
CLAUDE.md/AGENTS.md:这些文件会被推送到在该仓库中工作的任何代理的上下文窗口中。应极其谨慎地使用它们,通常仅用于指向其他文件的导航指针。CODING_STANDARDS.md:此文件在审查期间读取,而非实现期间。如果标准文件长度超过 1000 行,请在 Docs 文件夹中添加指向文档的导航指针。- Docs:将文档用作参考文件,由其他文件指向。在编写新文档之前,先查找现有文档。
- Skills:技能可用于文档(因为其描述会被放入代理的上下文窗口),或用于用户调用的命令。遵循
writing-for-agents技能中的建议。