跨会话智能任务追踪管理

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

基本信息

• 技能名称?task-runner
• 中文名称?跨会话智能任务追踪管理
• 作者?johstracke
• 分类?专业技能
• 版本?v1.0.1
• 标签?productivity, project-program-management, office, docs, automation

使用方法

使用说明
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 存储）。