mcpField
L
long-running-task-management

long-running-task-management

github.com/archieindianAgent 工作流7367 次安装26 周前更新
代码仓库

关于 long-running-task-management

用于管理耗时较长或跨多个会话的任务的技能，面向需要在中断后继续工作的 Agent。它通过状态文件记录阶段、检查点和恢复时的下一步。

主要功能

  1. 01创建任务状态文件
  2. 02记录阶段状态和检查点
  3. 03中断后从待处理阶段恢复
  4. 04完成后执行全面验证

适用场景

  1. 01跟踪预计超过 30 分钟的任务
  2. 02跨多个会话推进工作
  3. 03协调涉及多个目录的文件修改

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/archieindian/openclaw-superpowers --skill long-running-task-management

安装后在 Claude Code 中输入/long-running-task-management确认已加载。

附带文件STATE_SCHEMA.yaml

详细介绍

长时间运行的任务管理

状态文件：~/.openclaw/skill-state/long-running-task-management/state.yaml

适用场景

  • 预计任务耗时超过 30 分钟
  • 任务将跨越多个会话
  • 任务会修改多个目录中的许多文件

开始任务

  1. 将初始状态写入状态文件：
    • task_id：简短的 kebab-case 名称
    • status: in_progress
    • description：一句话描述目标
    • stages：按顺序排列的列表，每项的 status: pending
    • started_at：当前时间戳
  2. 开始第一个阶段

每个检查点

  1. 完成当前阶段
  2. 运行测试／验证
  3. 更新状态文件：将阶段标记为 status: complete，填写 checkpoint（当前已稳定的内容），填写 next_action（恢复时首先要做的事），更新 last_updated
  4. 如适用，将进度提交到 git

中断后恢复

  1. 读取状态文件
  2. 检查 status 和 next_action
  3. 从下一个 pending 阶段继续——不要从头开始

完成任务

  1. 更新状态：设置 status: complete，填写最终的 checkpoint
  2. 运行完整验证

Cron 唤醒行为

每次 15 分钟唤醒时：

  • 读取状态文件
  • 如果 status: in_progress 且 last_updated 已过时（超过 30 分钟）：将检查点更新记录到每日记忆中
  • 如果 status: complete 或没有活动任务：跳过

评论

支持 Markdown