agent-task-tracker

🗂️ 会话永续的任务记忆中枢

会话级任务状态管理工具,自动追踪任务生命周期,确保会话重置后上下文不丢失。

收藏
2.2k
安装
1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Task Tracker 是一种自动触发的状态管理技能,非用户调用,在以下关键节点自动执行:

| 触发时机 | 操作 |
|---------|------|
| 任务接收 | 创建条目,标记 🔄 进行中 |
| 后台进程启动 | 记录 session ID、PID、服务器、命令 |
| 进度更新 | 同步状态与备注 |
| 任务完成 | 标记 ✅ 完成,记录结果/链接 |
| 任务失败 | 标记 ❌ 失败,记录错误信息 |
| 会话启动 | 读取 `memory/tasks.md` 恢复上下文 |

技术实现

  • 存储位置: memory/tasks.md(会话持久化文件)
  • 格式: Markdown 结构化日志,支持快速扫描
  • 容量控制: 严格限制 50 行 / 2KB,避免启动加载负担
  • 归档策略: 完成的任务保留最近 10 条,3 天以上自动清理

显著优点

1. 会话韧性: 核心卖点——系统重启、上下文压缩后仍能恢复任务状态
2. 后台进程追踪: 显式记录 SSH 会话、长运行任务的 PID 和位置,防止"孤儿进程"

3. 零用户负担: 全自动触发,无需学习成本

4. 结构化可读: Markdown 格式兼顾机器解析与人眼快速浏览

潜在局限

  • 容量硬限制: 2KB 上限意味着复杂项目需配合外部日志(daily notes)
  • 非分布式: 单文件设计无法跨多实例同步
  • 无冲突解决: 并发修改场景未定义处理策略
  • 依赖文件系统: 若 memory/ 目录权限异常会静默失效

适合人群

  • 长会话用户: 需要数小时/跨天持续工作的复杂任务
  • 多服务器操作者: SSH 到多台机器执行后台任务
  • 自动化工作流: 依赖进程状态监控的 pipeline 场景
  • 易中断环境: 网络不稳或系统资源受限导致频繁重置

常规风险

| 风险等级 | 场景 | 缓解建议 |
|---------|------|---------|
| 低 | 文件损坏/丢失 | 依赖系统级备份,本身无冗余机制 |
| 中 | 状态与实际不同步 | 强调 write-first 规则,但极端 crash 仍可能丢失最后更新 |
| 低 | 敏感信息泄露 | `memory/tasks.md` 可能含服务器名、命令片段,需注意权限设置 |

架构定位

这是 AI 辅助系统的元能力(meta-skill)——不直接解决用户问题,而是保障解决过程的连续性。类似操作系统的进程表,存在感低但故障影响大。

agent-task-tracker 内容

手动下载zip · 2.4 kB
skill-card.mdtext/markdown
请选择文件