什么是 长期运行代理技能？

长期运行代理技能旨在改变 AI 代理与复杂的长期开发项目的交互方式。通过提供标准化的状态管理框架，它确保代理可以在不丢失上下文的情况下无缝恢复工作。这是通过一套专门的工作流文件实现的，这些文件负责跟踪任务完成情况、优先级和历史进度。对于需要 AI 协作处理而不仅仅是单次任务的开发者来说，它是 Openclaw 技能库中必不可少的补充。

此技能填补了原子编码会话与全面项目生命周期之间的空白。它利用透明的日志系统和结构化的任务模式，允许代理作为一个持久实体运行，理解已经完成的工作以及接下来的任务。无论你是从头开始构建新应用程序，还是重构旧代码库，此技能都为一致的 AI 驱动开发提供了必要的保障。

下载入口:https://github.com/openclaw/skills/tree/main/skills/yonghaozhao722/longrunning-agent

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

长期运行代理技能 应用场景

• 启动需要多个开发会话才能完成的复杂软件项目。
• 在维护清晰的 AI 先前操作历史的同时，恢复现有代码库的工作。
• 编排必须严格遵守任务依赖关系的多步骤迁移。
• 以人类和 Openclaw 技能代理都易于阅读的格式跟踪增量进度和里程碑。

1. 代理首先读取 progress.txt 文件，将其当前上下文与之前会话中执行的工作同步。
2. 它评估 task.json 文件，以识别满足所有依赖项的下一个高优先级任务。
3. 如果存在初始化脚本，代理将执行该脚本以为特定任务准备环境。
4. 代理执行实际的实现或重构工作，专注于单个原子任务以确保质量。
5. 运行集成测试、构建和 lint 流程，以验证实现是否符合项目标准。
6. 进度日志会更新该会话期间执行的工作摘要。
7. 结构化数据文件中的任务状态将更新以反映完成情况，并触发 git commit 以保存状态。

长期运行代理技能 配置指南

要开始使用，请将技能目录移至 Openclaw Skills 文件夹中。确保您的环境已安装 Claude Code CLI。您可以使用以下命令初始化新项目：

mkdir my-project && cd my-project
claude -p "使用 longrunning-agent 工作流初始化此项目"

确保 templates 目录可访问，以便代理可以生成初始的 CLAUDE.md 和 task.json 文件。

长期运行代理技能 数据架构与分类体系

该技能依赖于特定的基于文件的架构来维护项目状态并为 Openclaw 技能中的代理提供上下文：

JSON 文件中的任务包含用于跟踪的元数据，确保代理始终知道依赖链中的哪个步骤处于活动状态。

name: longrunning-agent
description: "Enables AI agents to work on long-running projects across multiple sessions. Use when starting complex projects, resuming work on existing projects, managing task lists with priorities and dependencies, or tracking progress incrementally."

OpenClaw Long-Running Agent Skill

This skill enables AI agents to work on long-running projects across multiple sessions.

Purpose

The longrunning-agent skill provides a structured workflow for:

• Tracking progress across sessions
• Managing task lists with priorities and dependencies
• Making incremental, atomic progress on complex projects
• Ensuring continuity when resuming work

Installation

1. Copy this skill directory to your OpenClaw skills folder
2. Ensure Claude Code CLI is installed and configured
3. Create a project directory with the workflow files

Usage

Initialize a New Project

# Create project directory
mkdir my-project && cd my-project

# Initialize workflow files
claude -p "Initialize this project using the longrunning-agent workflow"

Workflow Files

The skill expects these files in the project directory:

• CLAUDE.md - Project instructions and workflow guide
• task.json - Task list with priorities and dependencies
• progress.txt - Log of work completed
• init.sh - Environment setup script (optional)

Task Format

{
  "tasks": [
    {
      "id": "task-1",
      "description": "Set up project structure",
      "priority": 1,
      "dependencies": [],
      "passes": false
    },
    {
      "id": "task-2",
      "description": "Implement core features",
      "priority": 2,
      "dependencies": ["task-1"],
      "passes": false
    }
  ]
}

Progress Format

[2024-01-15 10:30:00] Started session
[2024-01-15 10:35:00] Completed task: Set up project structure
[2024-01-15 10:40:00] Milestone: Core features implemented

Workflow Steps

1. Read Progress - Check progress.txt for recent work
2. Select Task - Find next passes: false task with met dependencies
3. Initialize - Run init.sh if needed
4. Implement - Work on one task incrementally
5. Test - Run lint, build, and tests
6. Document - Update progress.txt
7. Mark Complete - Set passes: true in task.json
8. Commit - Make atomic git commit

Best Practices

• Work on ONE task per session
• Make commits after each task completion
• Keep progress.txt concise but informative
• Use dependencies to manage task order
• Test thoroughly before marking passes: true

Integration with Web UI

This skill integrates with the Agent Workflow Web App:

• Tasks sync with the web database
• Progress entries are captured
• Session output is logged
• Git commits are tracked

Templates

Templates for workflow files are in the templates/ directory:

• CLAUDE.md.tpl - Project template
• task.json.tpl - Task list template