Task Tracker

核心用法

Task Tracker 是一个被动触发的状态管理系统，而非用户主动调用的工具。它在每个任务的关键节点自动执行：任务接收时创建记录、后台进程启动时捕获会话信息、进度变化时更新状态、完成或失败时归档结果。所有状态持久化存储于 memory/tasks.md，确保会话重置或上下文压缩后仍能恢复任务连续性。

显著优点

1. 会话韧性：核心设计目标是解决 LLM 会话中断导致的上下文丢失问题，通过文件级状态持久化实现"断点续传"
2. 后台进程感知： uniquely 记录 SSH 会话 ID、PID、服务器及命令，解决远程任务追踪难题
3. 自动化运维：无需用户干预，嵌入任务流转的自然节点，降低心智负担
4. 轻量高效：硬性限制 50 行/2KB，强制简洁，避免状态文件膨胀

潜在局限

• 非用户可控：被动触发机制意味着用户无法直接查询或手动干预状态
• 信息压缩 trade-off：简洁性要求可能导致关键细节丢失，需依赖外部日志补充
• 单点故障：所有状态集中于单一文件，若文件损坏或权限问题将丢失全局状态
• 无冲突解决：并发任务写入同一文件存在潜在竞态条件（未明确提及锁机制）

适合人群

• 需要执行长时间后台任务（如服务器部署、大数据处理）的开发者
• 多会话、多设备切换工作的技术团队
• 对任务连续性有强要求的自动化工作流场景

常规风险

• 数据隐私：任务描述可能包含敏感信息，持久化文件需妥善保护
• 状态漂移：自动触发若失败，实际执行与记录状态可能不一致
• 存储依赖：依赖文件系统可用性，容器化/无服务器环境需额外配置持久卷

核心用法

task-tracker 是一个纯文档型的任务状态管理协议，通过标准化 memory/tasks.md 文件实现跨会话的上下文持久化。其核心机制包括：

• 状态机驱动：每个任务经历 🔄进行中 → ✅完成/❌失败/⏸️暂停 的完整生命周期
• 后台进程追踪：自动记录 SSH session ID、PID、服务器节点及执行命令，防止 orphan 进程
• 断点续续：会话启动时读取状态文件，无需历史对话即可恢复任务上下文
• 容量管控：硬性限制 50 行/2KB，自动归档 3 天前已完成任务，确保加载效率

显著优点

1. 零安全攻击面：纯 Markdown 文档，无可执行代码、无外部依赖、无网络请求，获 S+ 安全评级
2. 协议级通用性：不绑定特定 Agent 框架，任何支持文件操作的系统均可实现
3. 背景进程透明化：解决 AI Agent 长期运行的核心痛点——会话中断后进程状态丢失
4. 人机可读：状态文件可直接人工查阅、手动编辑，兼具机器协议与人机交互双重价值

潜在局限

• 无自动化保障：依赖 Agent 主动调用，若实现者未遵守 "write-first" 规则，状态可能滞后
• 单文件瓶颈：高并发任务场景下可能触及 2KB 限制，需配合外部日志系统
• 无冲突解决机制：多 Agent 同时写入同一文件时缺乏锁机制，存在覆盖风险
• 格式刚性：强制 emoji 与特定字段，与非 Markdown 工作流集成成本较高

适合人群

• 开发长时运行 AI Agent 的工程师（需处理 SSH/后台任务/多步骤工作流）
• 追求可审计、可调试会话状态的团队
• 对安全极度敏感、希望消除供应链攻击面的企业用户

常规风险

• 实现一致性风险：不同 Agent 对 "progress update" 的粒度理解差异可能导致状态碎片化
• 隐私泄露：memory/tasks.md 明文存储任务细节，共享工作区需注意敏感信息脱敏
• 归档策略误配：3 天自动清理可能导致需要长期追溯的任务摘要丢失