task-runner

📋 跨会话智能任务追踪管理

基于本地持久化存储的跨会话任务管理工具,具备完善路径安全验证,帮助用户高效追踪项目进度并支持 Markdown 导出。

收藏
3.7k
安装
1.2k
版本
v1.0.1
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

Task Runner 是一款专注于跨会话任务管理的生产力工具,通过本地 JSON 文件实现数据的持久化存储,解决了 AI 对话中任务状态随会话结束而丢失的痛点。

核心用法

该技能通过命令行接口提供完整的任务生命周期管理。用户可使用 add 命令创建带有项目分组和优先级标记的任务,利用 list 命令按项目筛选查看待办事项,通过 complete 标记任务完成状态,并借助 export 将项目进度导出为 Markdown 格式。所有数据存储于 ~/.openclaw/workspace/tasks_db.json,确保跨会话连续性。

显著优点

首要优势是真正的持久化存储,不同于会话级的临时记忆,任务数据以结构化 JSON 形式保存在本地,重启后依然可用。其次,项目化组织支持多维度任务分类,配合高中低三级优先级体系,便于用户聚焦关键事项。安全性方面,v1.0.1 版本引入了严格的路径验证机制,通过 is_safe_path 函数限制导出操作仅能写入用户工作区、家目录或 /tmp,有效防止了提示注入攻击导致的系统文件写入风险。此外,纯 Python 标准库实现零外部依赖,避免了供应链攻击风险。

潜在缺点与局限性

当前版本采用单文件存储架构,所有任务集中存储于一个 JSON 文件,若文件损坏或误删将导致全部数据丢失,缺乏内置的备份与恢复机制。功能层面,无多设备同步能力,数据绑定于单一机器,无法满足移动办公需求。代码质量方面,异常处理使用裸 except: 语句捕获所有异常,虽不影响安全性,但可能掩盖特定的逻辑错误,增加调试难度。来源可信度为 T3 级(个人开发者),长期维护的稳定性有待观察。

适合的目标群体

该技能特别适合长期运行的多会话项目,如学术研究中的实验跟踪、软件开发 Sprint 规划、以及自主智能体的工作流管理。对于需要离线优先、注重数据隐私的用户(数据不出本地),或是希望建立结构化待办事项系统的个人知识工作者,都是理想选择。

使用风险

主要风险集中在数据持久性方面:单点故障风险(需手动备份 tasks_db.json)、无版本控制(误操作不可逆)。性能上,随着任务量增长(数千条以上),JSON 文件的读写效率可能成为瓶颈。安全层面虽通过路径验证,但用户仍需警惕导出路径的确认,避免覆盖重要文件。建议定期备份数据文件,并避免在任务描述中存储高度敏感信息(因以明文 JSON 存储)。

安全解读

核心用法

Task Runner 是一款轻量级命令行任务管理工具,专为多会话工作环境设计。用户可通过简单命令添加任务(支持项目分组与三级优先级)、列出待办/已完成事项、标记完成状态,并将项目导出为 Markdown 报告。所有数据持久化存储于本地 JSON 文件,会话间自动保留。

关键指令

  • add "描述" [项目] [priority] — 创建任务
  • list [项目] — 查看任务列表
  • complete <id> / priority <id> <level> — 状态与优先级管理
  • export "项目" "路径" — 导出 Markdown 报告

显著优点

1. 跨会话持久化:任务数据存储于 ~/.openclaw/workspace/tasks_db.json,重启后不丢失,适合长期项目追踪。
2. 零依赖架构:纯 Python 标准库实现(json/pathlib/datetime),彻底消除供应链攻击风险。

3. 安全路径验证:export 功能实施白名单机制,阻止写入 /etc/~/.ssh 等敏感路径,有效防御 prompt injection 导致的权限提升攻击。

4. 结构化工作流:支持项目分组、优先级视觉标记(🔴🟡🟢)、时间戳记录,契合敏捷开发与实验追踪场景。

5. Markdown 导出:生成包含完成统计、待办/已办分区的干净报告,便于归档与分享。

潜在局限

1. 无删除功能:当前版本仅支持标记完成,无法物理删除任务或归档旧项目,长期运行可能导致数据膨胀。
2. 简易冲突处理:多进程并发写入缺乏锁机制,极端场景下存在数据覆盖风险。

3. 协作缺失:纯本地存储,无多用户同步或云端备份能力。

4. task_id 验证薄弱:转换为整数前未显式校验类型,错误输入时用户体验欠佳。

适合人群

  • 独立开发者与研究人员,需跨会话追踪实验进度
  • 敏捷团队个人成员,用于 sprint 任务管理与日终复盘
  • AI 自主代理(autonomous agents),需维护跨轮次待办清单
  • 命令行优先用户,追求轻量、无依赖的极简工具

常规风险

  • 数据丢失:JSON 文件损坏或误删将导致任务历史丢失,建议定期导出备份
  • 路径绕过:虽实施安全验证,但用户仍需确保导出路径落在允许范围内(workspace、home、/tmp)
  • 隐私注意:任务描述可能包含敏感信息,需注意 Markdown 导出的分享范围

task-runner 内容

scripts文件夹
手动下载zip · 5.2 kB
task_runner.pytext/plain
请选择文件