longrunning-agent

📋 跨会话项目进度智能管家

基于 OpenClaw 平台的纯文档型工作流技能,通过结构化任务追踪与进度日志,帮助用户实现复杂项目的跨会话连续性管理与原子化推进。

收藏
2.5k
安装
666
版本
v1.1.1
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

该技能为 OpenClaw 平台用户提供了一套结构化的长期项目管理工作流解决方案,专门解决 AI 助手会话中断导致的上下文丢失问题。通过建立标准化的项目文档体系(CLAUDE.md 说明文件、task.json 任务清单、progress.txt 进度日志),用户可在多个独立会话间实现工作的无缝衔接与连续性管理。

核心用法遵循"读取-选择-执行-记录"的闭环流程:首先查阅 progress.txt 了解历史进展,从 task.json 中筛选出满足依赖条件的待办任务,执行原子化的开发工作,最后更新进度日志并标记任务完成。技能强调单次会话仅处理一个任务,配合 Git 原子提交,确保项目状态清晰可追溯。同时提供 Web UI 集成能力,支持任务同步、进度捕获和提交跟踪。

显著优点在于其纯文档架构带来的极高安全性与灵活性。作为零代码执行的风险指导型技能,它不涉及任何脚本运行或外部调用,仅通过标准化文档模板规范用户行为,既避免了自动化工具的安全隐患,又赋予用户完全的控制权。工作流的增量式推进机制特别适合复杂项目的拆解执行,而优先级与依赖管理系统能有效防止任务遗漏或顺序混乱。

潜在局限性主要体现在自动化程度的缺失。该技能本质上是一套最佳实践指南,所有操作仍需用户手动执行,包括文件更新、状态标记和 Git 提交,对使用者的自律性要求较高。此外,作为个人开发者维护的 T3 级来源项目,其长期维护稳定性与功能迭代速度可能不及官方或企业级工具。对于追求全自动 CI/CD 集成的团队,这种半手动模式可能显得效率不足。

目标用户群体主要是需要长期使用 Claude Code 处理复杂开发任务的独立开发者或小团队,特别是那些项目周期跨越多个工作日的场景。适合研究型项目、大型功能重构、多模块系统开发等需要精细进度追踪的工作。不适用需要实时协作或全自动流水线的高频迭代环境。

常规使用风险相对可控,但需注意用户自行创建的 init.sh 等环境脚本可能引入安全隐患,建议严格审查自定义命令。手动维护 JSON 和文本文件存在误操作导致数据不一致的可能,建议配合版本控制使用。虽然技能本身无网络行为,但可选的 gh 工具集成需要确保本地 GitHub CLI 环境的安全配置。

安全解读

核心用法

OpenClaw Long-Running Agent Skill 是一套纯文档型项目管理规范,旨在解决AI Agent在多轮会话中断后难以保持上下文连续性的问题。用户通过创建标准化的CLAUDE.md项目指南、task.json任务清单和progress.txt进度日志,实现"会话-任务-提交"的原子化工作流。

典型使用流程:初始化项目目录 → 查阅progress.txt了解历史进度 → 从task.json筛选满足依赖条件的待办任务 → 单会话内完成一个任务 → 更新进度日志 → 标记任务完成并提交Git。Skill强制"一任务一会话"的约束,避免范围蔓延。

显著优点

  • 零代码风险:仅含Markdown与JSON模板,无可执行脚本,从根本上杜绝恶意代码注入
  • 状态持久化:通过文件系统而非内存维持项目状态,天然支持任意时长中断恢复
  • 依赖管理:任务JSON支持显式依赖声明,自动推导执行顺序
  • 审计友好progress.txt提供人类可读的线性历史,便于回溯决策

潜在局限

  • 无主动同步:Skill本身不执行文件I/O,需用户或外部Agent手动读写工作流文件
  • 冲突解决缺失:多并发修改场景下无内置锁机制或合并策略
  • 模板简陋:任务优先级仅用整数表示,缺乏复杂调度能力(如截止日期、资源约束)
  • T3来源风险:维护者为个人开发者,无企业背书,长期维护存疑

适合人群

  • 使用Claude Code CLI进行长期迭代开发的专业用户
  • 需要跨天/跨周持续跟踪复杂任务进度的Agent工作流设计者
  • 对代码安全极度敏感、拒绝引入任何可执行Skill的保守型用户

常规风险

| 风险类别 | 等级 | 说明 |
|---------|------|------|
| 代码执行 | 无 | 纯文档,无Shell/Python/JS可执行块 |
| 数据泄露 | 低 | 无API调用,但`progress.txt`可能记录敏感项目信息 |
| 供应链攻击 | 中 | T3来源,需人工验证仓库完整性 |
| 误操作 | 低 | 手动编辑JSON易破坏格式,建议配套Schema校验 |

综上,本Skill适合作为安全基线要求极高场景下的项目管理规范参考,实际生产使用建议配套自动化工具实现文件同步与校验。

longrunning-agent 内容

手动下载zip · 2.0 kB
manifest.jsonapplication/json
请选择文件