GitHub工具现已可作为eve扩展安装
内容提要
该文章介绍如何将GitHub工具作为扩展添加到eve代理中。通过安装@github-tools/eve-extension包，并在agent/extensions/目录下放置一个文件，即可获得42个工具，支持Vercel Connect认证、预设和审批规则。预设包括代码审查、问题分类等，令牌权限自动匹配，写操作默认需审批，可自定义规则。文件名设定命名空间，升级包可获取新工具。
延伸解读
安装与配置要点
安装只需两步：使用pnpm添加包，然后在agent/extensions/目录下放置一个文件（如github.ts）。文件名决定工具的命名空间，例如github__addPullRequestComment。配置通过导出默认函数完成，可指定连接器、预设和审批规则。升级包即可获得新工具和修复，配置模式在导入时验证。
认证与权限自动匹配
扩展使用Vercel Connect连接器进行认证，运行时生成短期、作用域受限的GitHub令牌。预设（如代码审查、问题分类）会自动映射到Connect作用域，确保令牌仅包含工具所需权限，减少过度授权风险。
审批规则灵活可配
所有写操作默认需要审批，但可针对单个工具设置审批策略：始终需要、仅一次，或基于输入的条件判断。例如，示例中仅当评论对象不属于vercel-labs组织时才要求审批，实现精细控制。
Q&A
如何将GitHub工具添加到eve代理中？
首先安装@github-tools/eve-extension包，然后在agent/extensions/目录下创建一个文件（如github.ts），并在其中导入并配置githubExtension，最后导出配置即可。
eve扩展中的GitHub工具集包含哪些预设？
预设包括code-review（代码审查）、issue-triage（问题分类）、repo-explorer（仓库探索）、ci-ops（CI操作）和maintainer（维护者）。
GitHub扩展如何实现认证？
通过Vercel Connect连接器进行认证，扩展会在运行时生成短期、作用域受限的GitHub令牌，令牌权限自动匹配所选预设对应的Connect作用域。
如何设置GitHub工具的审批规则？
默认所有写操作都需要审批。可以通过requireApproval配置为单个工具设置always、once或基于输入条件的谓词，例如仅对非自己组织的评论需要审批。
GitHub工具在eve代理中如何命名？
工具名称由文件名决定命名空间，例如文件名为github.ts时，工具会以github__addPullRequestComment的形式运行。
如何获取GitHub扩展的新工具和修复？
升级@github-tools/eve-extension包即可获取新工具和修复，配置模式会在导入时进行验证。
