task-tracker

任务跟踪器

管理 todos.md——由 action-item-extractor 技能维护的中央任务列表。 添加任务后，使用此技能查看、更新和监控任务。

配置

默认路径（请根据你的环境进行编辑）：

TODOS_FILE: ~/todos.md

---

操作

1. 列出事项

显示未完成的待办事项，可按负责人筛选。

步骤：

1. 读取 todos.md
2. 提取 ## Open 下所有匹配 - [ ] 的行
3. 如果提供了负责人筛选条件，则仅返回包含 **{Owner}** 的行
4. 按以下格式输出：

   Open todos [for {Owner}]:
   1. [{Owner}] {Task} — due: {deadline} (source: {source})
   ...
   

5. 如果没有匹配项：“没有未完成的待办事项[，负责人：{Owner}]。”

使用示例：

• “显示所有未完成的待办事项”
• “Alice 需要做什么？”
• “列出 Bob 的任务”

---

2. 完成事项

将待办事项标记为已完成。

步骤：

1. 读取 todos.md
2. 确定匹配的事项——可通过编号（来自列表输出）、负责人 + 关键词或确切的任务文本来识别
3. 如果存在歧义（有多个匹配项），显示选项并请用户确认
4. 将 - [ ] 改为 - [x]，并附加 _(completed: {today's date})_
5. 将该行从 ## Open 移至 ## Done
6. 写入更新后的文件
7. 确认：“已标记为完成：{task}”

使用示例：

• “将 Alice 的设计任务标记为完成”
• “完成第 2 项”
• “完成：项目提案”

---

3. 按负责人查询

显示特定人员的所有待办事项（未完成和已完成）。

步骤：

1. 读取 todos.md
2. 提取 ## Open 和 ## Done 下所有匹配 **{Owner}** 的行
3. 按以下格式输出：

   Todos for {Owner}:
   
   Open:
   - {Task} (due: {deadline})
   
   Done:
   - {Task} (completed: {date})
   

4. 如果没有找到：“未找到 {Owner} 的待办事项。”

---

定时提醒

每次定时运行时，检查已逾期或即将到期的任务。

步骤：

1. 读取 todos.md
2. 对每个有明确截止日期（非 TBD）的未完成事项：
   • 如果 due date < today：标记为已逾期
   • 如果 due date <= today + 2 days：标记为即将到期
3. 如果存在已标记的事项，发送提醒：

   ⚠️ Task Alert:
   Overdue ({N}):
   - [{Owner}] {Task} — was due {date}
   Due soon ({N}):
   - [{Owner}] {Task} — due {date}
   

4. 如果没有任何已标记的事项：无需提醒，静默退出

**提示：**将 Agent 配置为定期运行此技能， 以便在无需手动提示的情况下自动发送逾期提醒。

---

错误处理

• **找不到文件：**通知用户 todos.md 尚不存在。请其运行 action-item-extractor 或手动添加任务
• **完成事项时存在歧义：**显示匹配的事项，并询问用户要确认哪一项
• **未设置截止日期（均为 TBD）：**定时检查将静默跳过提醒
• **todos.md 格式错误：**通知用户，并询问是要覆盖为干净的模板，还是尝试修复