loop 循环任务与 Goal 模式

/loop 是 SolonCode 的循环任务与目标驱动引擎，支持两种运行模式：定时心跳（HEARTBEAT） 和 目标驱动（GOAL）。它是 SolonCode 实现自主持续运行的核心能力。

1、两种任务类型

2、命令参考

2.1 管理命令

2.2 创建心跳任务

/loop 5m check if deployment finished     ← 每 5 分钟执行一次
/loop 30s check CI status                 ← 每 30 秒（自动向上取整为 1 分钟）
/loop check CI status                     ← 默认 5 分钟
/loop cron:"0 */5 * * * ?" check status   ← 使用 cron 表达式
/loop 5m --now check status               ← 立即执行首次（--now 标志）

2.3 创建 Goal 任务

/loop goal fix auth module                ← 简化 Goal 模式，立即执行
/loop goal write a readme.md              ← 编写文档
/loop goal --max-tokens:50000 refactor    ← 限制 Token 预算
/loop goal --max-duration:30 fix tests    ← 限制时间预算（单位：分钟）

注意：每个会话同一时间只能有一个活跃的 Goal。需先 /loop stop <id> 才能创建新 Goal。

3、Goal 状态机

Goal 模式拥有完整的 5 态状态机，实现可中断、可恢复的自主推进：

PURSUING ⇄ PAUSED → ACHIEVED | BUDGET_LIMITED
    ↓
  BLOCKED → (resume) → PURSUING

状态变更方法：

4、Goal 模式深入

4.1 AI 侧工具

Goal 模式下，系统会向 AI 暴露两个工具（仅在存在活跃 Goal 时动态加载，无 Goal 时不出现）：

goal_get 返回值示例：

{
  "goal": {
    "taskId": "a1b2c3d4",
    "objective": "fix auth module",
    "status": "pursuing",
    "iteration": 3,
    "elapsedSeconds": 120,
    "consumedTokens": 15000,
    "maxTokens": 50000,
    "budgetExceeded": false,
    "maxDurationMs": 1800000,
    "remainingDurationSeconds": 1680
  },
  "remaining_tokens": 35000,
  "completionBudgetReport": null
}

4.2 Budget 预算管理

Goal 模式支持 Token 和时间双重预算控制：

预算阈值体系： - 警告阈值（默认 70%）：引导词中提示 AI 调整策略 - 紧急阈值（默认 85%）：引导词中增加紧急提示 - 预算耗尽：触发 wrap-up 收尾回合，AI 总结进展后状态转为 BUDGET_LIMITED

预算感知引导词（Budget-Aware Prompting）：

4.3 运行时兜底机制

5、配置参考（settings.json）

在 settings.json 的 loop 节点下配置：

{
  "loop": {
    "budgetWarningPercent": 70,
    "budgetCriticalPercent": 85,
    "defaultMaxTokens": 100000,
    "defaultMaxDurationMinutes": 60,
    "stagnationThreshold": 3,
    "maxConsecutiveErrors": 3,
    "validatorEnabled": true
  }
}

6、Goal 验证器

当 AI 调用 goal_update(complete) 标记目标完成时，系统会先执行客观验证：

• 默认验证器（NoopValidator）：始终返回通过
• 自定义验证器：可注册实现 GoalValidator 接口的验证器，执行如运行测试套件、检查文件存在等客观校验
• 插件化：通过 ValidatorFactory 根据目标条件自动匹配验证器

验证失败时，系统会返回错误信息，AI 继续改进后重新提交。

7、持久化与恢复

• 所有 Loop 任务持久化在会话目录的 loop-tasks.json 文件中
• 使用原子写入（先写 .tmp 再 atomicMove），防止写入中断导致数据损坏
• 进程重启后自动：
  1. 加载 loop-tasks.json 恢复未取消的任务
  2. 重新注册调度
  3. 自动 resume 暂停/阻塞状态的 Goal（从 SIGINT 中断恢复）
• 每轮执行后实时持久化状态

8、完整示例

定时检查 + Goal 修复

# 每隔 5 分钟检查构建状态
/loop 5m check if the CI build passed

# 查看所有任务
/loop ls

# 发现构建失败，创建 Goal 任务修复
/loop goal --max-tokens:50000 fix the CI build failure

# 查看 Goal 进展
/loop ls

# 临时暂停 Goal
/loop pause a1b2c3d4

# 恢复 Goal
/loop resume a1b2c3d4

# Goal 完成后，停止定时检查
/loop stop b2c3d4e5

带有预算控制的 Goal

# 重构代码库，限制在 50000 Token 和 30 分钟内
/loop goal --max-tokens:50000 --max-duration:30 refactor the payment module

# 查看任务状态
/loop ls

9、与 /continue 的关系

提示：如果只是想从上一次对话继续，使用 /continue。如果需要 AI 自主推进一个目标直到完成，使用 /loop goal。