TODO Tracker

核心用法

TODO Tracker 是一款轻量级任务管理技能，通过维护工作区根目录的 TODO.md 文件实现跨会话持久化。用户可通过自然语言指令添加、完成、移除任务，或按优先级筛选查看。系统支持三级优先级（🔴高/🟡中/🟢低），自动记录添加日期，并在心跳检测时提醒过期任务。

显著优点

1. 会话连续性：任务数据以 Markdown 格式持久存储，重启后状态不丢失
2. 语义化交互：支持 "add X to TODO"、"mark X done" 等口语化指令
3. 智能提醒：内置 7 天过期检测（STALE 标记），配合心跳机制主动推送
4. 可视化输出：Emoji 优先级标识 + 结构化列表，阅读体验友好
5. 脚本化后端：Bash 脚本封装复杂操作，便于扩展和维护

潜在局限

• 单文件架构：大量任务时 TODO.md 可能臃肿，缺乏分页或归档机制
• 无并发控制：多实例同时写入存在冲突风险（无文件锁）
• 搜索能力弱：仅支持简单文本匹配，无法全文检索或标签过滤
• 权限依赖：需工作区写权限，受限环境（如容器只读）无法运行
• 无同步机制：跨设备使用需手动管理文件同步

适合人群

个人开发者、小型团队协作、需要轻量级任务追踪且不希望引入复杂项目管理工具的用户。特别适合 AI 助手场景——作为"外部记忆"补充对话上下文的遗忘局限。

常规风险

• 数据丢失：未配置备份时，误删 TODO.md 或脚本异常导致内容损坏不可恢复
• 隐私泄露：明文存储任务内容，敏感信息可能暴露于共享工作区
• 注入风险：用户输入直接拼接到 shell 命令，需确保脚本做好参数转义
• 过期提醒疲劳：高频心跳可能产生过多干扰，建议允许用户配置提醒阈值

核心用法

TODO Tracker 是一款轻量级本地任务管理 Skill，通过维护工作目录下的 TODO.md 文件实现跨会话持久化。用户可通过自然语言指令完成增删改查：

| 操作 | 触发语 | 命令 |

|------|--------|------|

| 查看任务 | "what's on the TODO?" | `cat TODO.md` + 智能摘要 |

| 添加任务 | "add X to TODO" / "TODO: X" | `todo.sh add <priority> "<item>"` |

| 完成任务 | "mark X done" / "finished X" | `todo.sh done "<pattern>"` |

| 删除任务 | "remove X from TODO" | `todo.sh remove "<pattern>"` |

| 按优先级筛选 | - | `todo.sh list high/medium/low` |

优先级分为三档（🔴 高 / 🟡 中 / 🟢 低），支持模糊匹配操作。心跳机制自动检测超过 7 天的陈旧任务并提醒。

显著优点

1. 零依赖轻量架构：纯 Bash 实现，零外部依赖，启动与执行极速
2. Markdown 原生格式：任务数据为人类可读的 Markdown，便于版本控制与手动编辑
3. 自然语言交互：无需记忆命令语法，对话式指令即可完成操作
4. 优先级与过期管理：内置三级优先级与自动陈旧检测，防止任务堆积遗忘
5. 安全合规：S 级安全认证，无网络通信、无敏感数据收集

潜在局限

• 单文件存储：所有任务集中在一个文件，大型团队协作场景下可能产生冲突
• 无云同步：纯本地实现，跨设备需借助外部同步工具（如 Git、Dropbox）
• 功能精简：不支持子任务、标签、截止日期提醒等高级功能
• Bash 兼容性：部分高级功能依赖特定 shell 环境

适合人群

• 个人开发者需要轻量级任务跟踪
• 追求数据本地可控、拒绝云服务的隐私敏感用户
• 已在终端工作流中的技术用户
• 需要与代码仓库同步管理任务的开源项目维护者

常规风险

• 文件丢失风险：TODO.md 未自动备份，误删或工作区清理将导致数据丢失
• 并发写入：多实例同时操作可能引发文件写入冲突（建议手动协调或 Git 管理）
• 路径依赖：默认依赖工作目录根路径，移动项目需迁移文件