OpenClaw 长时运行 Agent 技能

该技能使 AI Agent 能够跨多个会话持续处理长期项目。

用途

longrunning-agent 技能提供了一套结构化的协作流程，用于：

• 跨会话追踪项目进展
• 管理带优先级与依赖关系的任务列表
• 在复杂项目中以增量、原子化方式推进工作
• 确保恢复工作时的上下文连续性

安装

1. 将本技能目录复制到你的 OpenClaw skills 文件夹中
2. 确保已安装并配置 Claude Code CLI
3. 创建一个包含工作流文件的项目目录

使用方法

初始化新项目

# 创建项目目录
mkdir my-project && cd my-project

# 初始化工作流文件
claude -p "使用 longrunning-agent 工作流初始化本项目"

工作流文件

该技能要求项目目录中包含以下文件：

• CLAUDE.md — 项目说明与工作流指南
• task.json — 包含优先级与依赖关系的任务列表
• progress.txt — 已完成工作的日志记录
• init.sh — 环境初始化脚本（可选）

任务格式

{
  "tasks": [
    {
      "id": "task-1",
      "description": "搭建项目结构",
      "priority": 1,
      "dependencies": [],
      "passes": false
    },
    {
      "id": "task-2",
      "description": "实现核心功能",
      "priority": 2,
      "dependencies": ["task-1"],
      "passes": false
    }
  ]
}

进展日志格式

[2024-01-15 10:30:00] 启动会话
[2024-01-15 10:35:00] 完成任务：搭建项目结构
[2024-01-15 10:40:00] 里程碑：核心功能已实现

工作流步骤

1. 读取进展 — 检查 progress.txt 中的最新工作记录
2. 选取任务 — 查找下一个 passes: false 且所有依赖均已满足的任务
3. 初始化 — 如需，执行 init.sh
4. 实现 — 增量式地完成单个任务
5. 测试 — 运行 lint、构建及测试命令
6. 文档化 — 更新 progress.txt
7. 标记完成 — 将 task.json 中对应任务的 passes 设为 true
8. 提交 — 执行一次原子化的 git 提交

最佳实践

• 每次会话仅处理一个任务
• 每完成一个任务后立即提交
• progress.txt 应简洁但信息完整
• 利用依赖关系明确任务执行顺序
• 在将 passes 设为 true 前务必充分测试

与 Web UI 的集成

该技能与 Agent Workflow Web App 深度集成：

• 任务与 Web 端数据库实时同步
• 进展条目被自动捕获并持久化
• 会话输出内容被完整记录
• Git 提交历史被跟踪与展示

模板

工作流文件模板位于 templates/ 目录中：

• CLAUDE.md.tpl — 项目模板
• task.json.tpl — 任务列表模板