openclaw/smart-todo

Smart Todo Manager

功能概述

智能代办管理系统，提供以下核心能力：

| 功能 | 说明 | |------|------| | 优先级管理 | P0(最高)、P1(普通) | | 状态跟踪 | 未开始、进行中、已完成、暂停、终止 | | 智能重复检测 | 名称+描述双维度，80%相似度阈值 | | 上下文保存 | 自动捕获工作文件、对话历史、任务状态 | | 定时提醒 | 20分钟间隔状态汇报，P0超时提醒 | | 自动归档 | 已完成/终止代办自动转移到归档文件 |

触发条件

显式触发

用户明确表达添加代办意图：

• "加入代办：修复登录bug"
• "记一下，明天要开会"
• "添加到待办"
• "创建代办任务"

查询触发

用户询问代办状态：

• "查看我的代办"
• "待办列表"
• "有什么待办"
• "P0 代办有哪些"

工作中断触发

检测到用户切换任务意图：

• "先放下这个"
• "换个事"
• "等一下"
• "先做别的"
• "转移注意力"

中断处理流程：

1. 捕获当前任务上下文（打开文件、对话历史、任务状态）
2. 询问用户："检测到任务切换，是否为当前任务创建代办？"
3. 如确认，创建包含完整上下文的代办
4. 如拒绝，仍静默保存上下文供后续参考

工作流程

流程1：添加代办

1. 解析用户输入
   └─ 提取任务核心内容
   
2. 生成简略名称（≤10字）
   └─ 示例："修复登录API超时问题" → "修复登录超时"
   
3. 确认理解
   └─ 与用户对话确认任务理解正确
   └─ 记录确认后的理解内容
   
4. 捕获上下文
   └─ 当前打开的文件
   └─ 最近的文件修改
   └─ 对话历史（最近10条）
   └─ 当前任务目标
   
5. 重复检测
   └─ 名称相似度 >=70% 或 描述相似度 >=80%?
   └─ 任一满足 → 触发重复警告
   
6. 用户确认
   ├─ 无重复 → 直接创建
   └─ 有重复 → 询问：合并/新建/取消
   
7. 保存代办
   └─ 写入 active.md
   └─ 更新统计信息

流程2：重复检测

检测逻辑（OR 组合，任一维度触发即报警）：

if similarity(name_new, name_existing) >= 0.7 or \
   similarity(desc_new, desc_existing) >= 0.8:
    trigger_duplicate_warning()

名称阈值 70%（中文相似词匹配较松）、描述阈值 80% 均可在 config.json 中调整

用户提示：

⚠️ 检测到相似代办:

现有代办 [T003] P0 修复登录超时
- 描述: 用户登录API返回超时，需优化数据库查询
- 相似度: 名称 85%, 描述 90%

你的新代办是否与此相同?
[是，合并] [否，新建] [查看详情] [取消]

流程3：状态更新

状态流转图：

未开始 ──→ 进行中 ──→ 已完成 ✓ (归档)
   ↑         ↓
   └──── 暂停 ─┘
              ↓
            终止 ✓ (归档)

归档规则：

• 状态变为"已完成" → 移动到 archive.md，记录完成时间
• 状态变为"终止" → 移动到 archive.md，记录终止原因

流程4：定时提醒

触发时机：每次会话开始时检查

提醒内容：

📋 代办状态更新 (距上次 25 分钟)

活动代办: 5 个
├─ P0: 2 个 (⚠️ 1个已超时)
└─ P1: 3 个

⚠️ P0 代办提醒:
[T001] 修复支付接口 - 进行中 (已 1.5 小时)
建议: 是否需要帮助或调整优先级?

快捷操作:
- "标记 T001 完成"
- "暂停 T001"
- "查看详情"

文件结构

D:\knowledge\代办\
├── active.md           # 活动代办
├── archive.md          # 归档代办
└── config.json         # 用户配置（可选覆盖）

active.md 格式

# 活动代办列表

## 统计
- 总计: 3
- P0: 1
- P1: 2
- 进行中: 1
- 未开始: 1
- 暂停: 1

## 代办列表

### [T001] P0 修复登录超时
**状态**: 进行中
**创建时间**: 2026-03-31 10:00:00
**更新时间**: 2026-03-31 14:30:00
**预估时间**: 60分钟

**原始描述**:
用户反馈登录经常超时，需要排查是数据库问题还是网络问题

**确认理解**:
优化登录接口性能，目标响应时间 < 500ms

**上下文**:
捕获时间: 2026-03-31 10:05:00

【当前目标】
优化登录接口性能

【打开的文件】
  - src/api/auth.py
  - src/db/connection.py

【最近文件】
  - config/database.yml
  - tests/test_auth.py

【对话摘要】
  > 用户: 登录超时问题需要处理
  > 助手: 已记录，建议先检查数据库连接池

【备注】
工作中断 | 原因: 需要紧急处理支付bug

**标签**: #bug #性能优化

---

### [T002] P1 编写API文档
...

---
最后更新: 2026-03-31 15:00:00

配置选项

assets/config.json：

{
  "storage_path": "D:\\knowledge\\代办",
  "notification_interval_minutes": 20,
  "similarity_threshold": 0.8,
  "max_name_length": 10,
  "context_lines_from_history": 10,
  "p0_alert_threshold_hours": 1
}

| 配置项 | 说明 | 默认值 | |--------|------|--------| | storage_path | 代办文件存储路径 | D:\knowledge\代办 | | notification_interval_minutes | 提醒间隔（分钟） | 20 | | similarity_threshold | 重复检测阈值 | 0.8 | | max_name_length | 简略名称最大长度 | 10 | | context_lines_from_history | 保留对话历史条数 | 10 | | p0_alert_threshold_hours | P0超时提醒阈值（小时） | 1 |

使用示例

添加代办

用户: "加入代办，修复登录超时问题，用户反馈登录经常卡住"

助手:

已理解，创建代办：

简略名称: 修复登录超时 (8字)
优先级: P1 (默认)
预估时间: 20分钟 (默认)

确认理解：
用户登录接口响应慢，需要排查性能问题并优化

是否正确？
[正确，保存] [修改名称] [修改优先级] [取消]

检测到重复

用户: "加入代办，修复登录问题"

助手:

⚠️ 检测到相似代办:

现有代办 [T001] P0 修复登录超时
- 描述: 用户反馈登录经常超时...
- 相似度: 名称 90%, 描述 85%

操作选项:
1. 合并 - 更新现有代办
2. 新建 - 这是不同的问题
3. 查看 - 显示现有代办详情
4. 取消

工作中断检测

用户: "先放下这个，我去处理支付bug"

助手:

检测到任务切换。

当前任务: 修复登录超时 (进行中)
已耗时: 30分钟
打开文件: src/api/auth.py, src/db/connection.py

是否为当前任务创建代办以保存进度？
[是，保存上下文] [否，继续] [稍后提醒]

查看代办

用户: "查看代办"

助手:

📋 代办列表 (3个活动)

P0 (1):
├─ [T001] 修复登录超时 - 进行中 (30分钟)

P1 (2):
├─ [T002] 编写API文档 - 未开始
└─ [T003] 更新依赖包 - 暂停

操作: "查看 T001" / "完成 T002" / "全部详情"

边界情况处理

| 场景 | 处理方式 | |------|----------| | 名称超过10字 | 自动截断并提示用户 | | 重复检测冲突 | 显示相似代办，等待用户选择 | | P0超时未更新 | 主动提醒，询问是否需要帮助 | | 上下文捕获失败 | 记录失败原因，继续创建代办 | | 存储路径不存在 | 自动创建目录 | | 文件解析错误 | 备份原文件，重新初始化 |

实现依赖

• scripts/todo_manager.py - 核心CRUD和重复检测
• scripts/context_capture.py - 上下文捕获
• assets/config.json - 配置
• references/todo_template.md - 模板参考

版本

v1.0.0 - 初始版本

• 基础CRUD功能
• 重复检测
• 上下文捕获
• 自动归档