Jules CLI 技能

概述

此技能使智能体能够与jules命令行界面进行交互。它支持任务分配、会话监控和结果集成。

使用指南（至关重要）

为防止创建过多且不合适的会话，您必须遵守以下规则：

1. 本地优先：如果您能在当前本地环境（例如，编辑文件、运行测试、小规模重构）中解决任务，请勿使用Jules。
2. 复杂度门槛：仅将Jules用于以下类型的任务：
   • 大规模：涉及大量文件或需要重大架构变更。
   • 隔离性：能从干净的远程环境中受益，以避免本地依赖问题。
   • 探索性解决方案并非显而易见、需要在虚拟机中迭代执行的任务。
3. 禁止扩散（单次执行原则）：
   • 严禁为同一任务创建多个会话。
   • 严禁使用循环或并行执行方式同时启动多个会话。
   • 必须等待当前会话完成并检查结果后，方可决定是否需要启动新会话。
4. 禁止"微任务"：不得提交诸如"添加注释"、"修改变量名"或"更正拼写错误"等琐碎任务。

安全准则

为确保CLI命令的安全执行，您必须遵守以下安全规范：

1. 输入验证：执行任何命令前，请验证：
   • 仓库名称必须符合所有者/仓库名格式规范（仅限字母数字、点号、连字符和下划线）。
   • 会话ID由字母和数字组成（通常也允许使用连字符和下划线）。
2. 引用规则：始终用双引号包裹shell占位符（例如"<repo>"）。
3. 禁止内联注入：切勿将用户提供的数据直接嵌入脚本字符串（如python3 -c）。应使用环境变量安全传递此类数据。
4. 数据净化：若任务描述需直接传递给shell，必须确保其不包含恶意shell字符。

安全控制

• 必须获得批准（强制要求）：在运行以下任何命令前，必须获取用户的明确批准：
  • jules remote new：因为此命令会创建远程会话/虚拟机。
  • jules remote pull --apply：因为此命令会修改本地代码库。
  • 朱尔斯传送：由于这会克隆并修改环境。
• 验证：始终在创建新会话前运行jules remote list --session，以确保您没有针对同一仓库的待处理会话。
• 凭据：如果需要jules login，请向用户解释原因，并在继续之前等待他们的确认。

核心工作流程（手动控制）

建议直接使用命令行界面以保持对情况的了解。

1. 飞行前检查

验证仓库访问权限和格式。

jules remote list --repo

注意：确保仓库格式为GITHUB_USERNAME/REPO。

2. 提交任务

创建一个会话并捕获会话ID。

# Capture the output to get the ID
# Replace <repo> and task description with validated inputs
jules remote new --repo "<repo>" --session "Detailed task description" < /dev/null

3. 监控进度

列出会话并查找您的ID。使用这个稳健的一行命令来检查状态（它能处理像“进行中”这样带空格的状态）：

检查状态（安全方法）：

# Use an environment variable to pass the Session ID safely to Python
export JULES_SESSION_ID="<SESSION_ID>"
jules remote list --session | python3 -c "
import sys, re, os
session_id = os.environ.get('JULES_SESSION_ID', '')
if not session_id: sys.exit(0)
for line in sys.stdin:
    line = line.strip()
    if line.startswith(session_id):
        # Extract status (the last column after multiple spaces)
        print(re.split(r'\s{2,}', line)[-1])
"
unset JULES_SESSION_ID

4. 整合结果

一旦状态变为已完成，拉取并应用更改。

# Replace <SESSION_ID> with the validated Session ID
jules remote pull --session "<SESSION_ID>" --apply < /dev/null

错误处理与故障排除

• 未找到仓库：使用jules remote list --repo验证格式。它必须与GitHub路径匹配。
• TTY错误：对于使用原始jules命令的非交互式自动化，始终使用< /dev/null。
• 凭据：如果看到登录错误，请确保HOME环境变量设置正确，或运行jules login。

命令参考