Google Jules 教程：从 GitHub Issue 到可审查 Pull Request

Google Jules 最适合处理边界清楚、能够用测试或检查命令验收的 GitHub 任务。本教程不会把“开发一个完整产品”这种模糊需求交给 Agent，而是用一个真实维护任务走完仓库授权、环境配置、计划审查、代码修改、测试、diff 和 Pull Request。

示例任务是：为一个已经存在的解析函数补齐空输入与异常输入测试，并修复测试暴露的问题。你可以替换成依赖升级、小型 Bug、文档同步或 Lint 修复。

这篇教程会完成什么

完成后你会得到一套可重复的 Jules 工作流：

1. 只授权一个练习仓库。
2. 用 AGENTS.md 告诉 Jules 项目命令与边界。
3. 配置最小 setup script。
4. 从 GitHub Issue 或 Jules 页面创建任务。
5. 审查计划，而不是直接让 Agent 自由修改。
6. 检查活动日志、diff、测试和未完成项。
7. 创建 Pull Request，通过独立 CI 后再合并。
8. 记录成功率与返工时间，决定是否继续使用或升级。

开始前需要准备

• 一个 GitHub 账号和可测试的仓库。
• 仓库中已有安装锁文件，例如 package-lock.json、pnpm-lock.yaml 或 uv.lock。
• 至少一条稳定的测试命令。
• 一个不会接触生产数据的测试环境。
• 明确的分支保护和 Pull Request 审查规则。
• Jules 账号。免费层当前足够完成首次练习。

不要选择包含未轮换生产密钥的仓库。先运行秘密扫描，并检查 .env、CI 配置、部署脚本和示例文件是否泄露凭据。

第一步：只授权必要仓库

登录 Jules 后连接 GitHub。GitHub App 的授权页面通常允许选择所有仓库或指定仓库。首次使用应选择“Only select repositories”，只授权练习仓库。

完成任务后，如果暂时不用 Jules，可以在 GitHub 设置的 Applications 中重新配置或撤销访问。不要因为方便就把个人账号下的所有私有仓库永久授权给任何 Agent。

Jules 每个任务会在云端 VM 中克隆仓库并运行命令。官方说明 VM 有互联网访问，因此仓库里的安装脚本、测试脚本和依赖都可能产生外部请求。授权范围只是第一层，执行权限同样要控制。

第二步：准备 AGENTS.md

Jules 会读取仓库根目录的 AGENTS.md。内容应该短、具体、能影响执行，不要复制一整本工程手册。

示例：

Repository instructions

- Install dependencies with `npm ci`.
- Run unit tests with `npm test -- --runInBand`.
- Run type checks with `npm run typecheck`.
- Do not modify files under  or .
 Do not add dependencies unless the task explicitly requires it.
 Keep public function signatures backward compatible.
 Before finishing, list changed files, tests run, failures, and remaining risks.