Jules API调用

技能简介

该技能通过curl命令行工具调用Jules REST API (v1alpha)，实现与Google Jules自主AI编程代理的程序化交互。Jules能够接收编码任务指令，自动生成执行计划，完成代码修改并提交Pull Request。

业务背景

开发者无需登录Jules网页端，即可通过命令行批量发起编码任务。适合需要自动化处理多仓库代码维护、夜间定时修复或集成到现有CI/CD流程的团队，减少人工值守成本，让AI编程代理成为可调度的基础设施资源。

落地案例：某技术团队每周需对20个微服务进行依赖版本巡检。运维人员编写脚本调用Jules API：输入仓库列表和升级规则，自动创建批量会话；晨会前审批AI生成的执行计划，确认后由Jules完成代码修改并提交PR。全程无需逐一手动操作网页界面。

能做什么

• 查询已连接的GitHub仓库列表
• 创建编码任务会话并指定需求
• 实时监控会话状态和活动日志
• 审批或拒绝AI生成的执行计划
• 向运行中的会话发送补充消息
• 获取完成的PR链接和代码变更结果

使用说明

安装准备

1. 确保系统已安装curl和python3（用于JSON转义）
2. 可选安装node以使用jules.js CLI包装器

配置步骤

1. 访问 https://jules.google.com/settings#api 获取API密钥（最多保留3个）
2. 在Jules网页端安装GitHub应用并授权目标仓库
3. 设置环境变量：export JULES_API_KEY="your-api-key-here"

基础用法

# 验证仓库访问权限
./scripts/jules_api.sh sources

# 创建带计划审批和自动PR的会话
./scripts/jules_api.sh new-session \
  --source "sources/github/OWNER/REPO" \
  --title "Add unit tests" \
  --prompt "Add comprehensive unit tests for the authentication module" \
  --branch main \
  --require-plan-approval \
  --auto-pr

# 监控进度并审批计划
./scripts/jules_api.sh activities --session SESSION_ID
./scripts/jules_api.sh approve-plan --session SESSION_ID

注意：使用GitHub用户名/组织名，而非本地系统用户名（格式为sources/github/octocat/Hello-World）。

输入与输出

见下方输入与输出表格。

风险提示

• API密钥泄露可能导致未授权访问您的Jules会话和GitHub仓库
• 自动PR功能会直接修改远程仓库代码，建议先在测试仓库验证
• 计划审批环节不可跳过，需人工确认AI生成的执行方案
• 每个API密钥有使用配额限制，高频调用可能触发限流
• 会话状态可能因网络中断或API故障而同步延迟

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/sanjacob99/jules-and-lobster/SKILL.md
来源类型：GitHub仓库