---
title: "管理长任务"
description: "用 Goal 保持当前进程内的任务方向，并理解验证窗口、迭代上限与恢复边界。"
---

> Documentation Index
> Fetch the complete documentation index at: https://konghayao.github.io/peri-cool/llms.txt
> Use this file to discover all available pages before exploring further.

# 管理长任务

Goal 是 Agent 可调用的任务状态工具，适合在多轮工作中保存一个明确目标。输入 `/goal ...` 会作为文本提示触发内置 skill，再由 Agent 决定是否调用 `goal` 工具；它不是 TUI 本地实现的严格命令解析器。

## 创建一个可验证目标

直接用自然语言说明目标和验收条件：

```text
创建一个目标：把 src/auth 下的回调式接口迁移为 async/await。
验收条件：现有 API 行为不变；目标测试通过；列出没有运行的测试。
```

之后可以说：

```text
查看当前目标。
根据工作区证据完成当前目标。
当前缺少私有 registry 凭据，把目标标记为阻塞并记录原因。
清除当前目标。
```

同一进程内同一会话只有一个 active goal。新的目标与旧目标冲突时，先完成或清除旧目标。

## 完成验证怎样工作

当辅助模型可用时，完成动作会用目标描述和最近 **20 条非 System 消息**生成验证判断。因此：

- 在接近完成时重新给出测试结果、关键 diff 和未验证项。
- 不要假设很久以前的一条消息仍在验证窗口内。
- 把“测试通过”写成具体命令与结果，不要只写结论。

如果没有配置辅助模型，当前实现会直接完成目标，不执行这一步模型验证。无论界面显示什么，工作区、测试和外部系统仍是最终事实源。

## 持久化边界

> **Goal 不随进程恢复**
>
> 当前 active goal 使用内存存储。<code>peri -c</code> 可以恢复会话文本，但关闭或重启进程后不会自动恢复 active goal 状态。恢复对话后，请重新声明目标并核对工作区实际进度。

“会话可以继续”与“任务运行时状态仍存在”是两件事。后台任务、cron 和其他进程内状态也应分别检查，不能只根据历史消息判断。

## 迭代上限

当前一次 Agent 执行循环的默认上限是 500 个 iteration。它是防止单次循环无限运行的内部上限，不是跨天项目的总轮次承诺，也不表示 Agent 会在无人值守时自动工作到 500 轮。

大任务更适合分成可独立验证的阶段：

1. 先确认范围和基线测试。
2. 每一阶段只修改一组明确边界。
3. 阶段结束运行目标测试并记录剩余风险。
4. 需要新进程时，重新声明下一阶段 goal。

## 何时使用

适合 Goal：需要多轮工具调用、验收标准明确、过程中可能需要补充信息的任务。

不适合 Goal：单次解释、简单只读查询，或依赖外部时间触发的工作。后者应使用可靠的外部调度系统，而不是把 Goal 当守护进程。

Source: https://konghayao.github.io/peri-cool/docs/features/long-running-tasks/index.mdx