Todo - 待办事项管理

核心原则

简单直接，三区管理

• 重要: 高优先级的关键任务
• Todo: 普通待办任务
• Finish: 已完成的任务

文件格式

todo.md 使用标准 Markdown checkbox 格式：

# Todo

## 重要

- [ ] 高优先级任务1
- [ ] 高优先级任务2

## Todo

- [ ] 普通任务1
- [ ] 普通任务2

## Finish

- [x] 已完成任务1 ✅ 2026-01-19
- [x] 已完成任务2 ✅ 2026-01-18

工作流程

🔍 添加任务前的推理（重要）

在添加任何任务之前，必须执行以下思考：

1. 分析任务清晰度

检查任务描述是否：

• ✅ 具体明确: 有明确的行动和结果
• ✅ 可执行: 知道具体要做什么
• ❌ 过于模糊: 如"写代码"、"做优化"

2. 任务不清晰时的处理

如果任务描述不够具体，必须询问用户：

任务"XXX"不够具体，请问：
1. 具体要做什么？
2. 预期结果是什么？
3. 有没有特定的约束或要求？

示例：

• ❌ 用户说"优化代码" → 询问具体要优化什么
• ❌ 用户说"写文档" → 询问是什么文档，给谁看
• ✅ 用户说"实现用户登录API" → 清晰，可直接添加

3. 适度拆分任务

如果任务过于复杂，建议拆分：

示例：

用户: "部署到生产环境"

AI: 这是一个复杂任务，建议拆分为：
1. 准备部署配置
2. 备份当前数据
3. 执行数据库迁移
4. 部署新版本
5. 验证部署结果

要按这个拆分添加吗？

4. 自动判断优先级

根据任务内容自动判断放入哪个区域：

放入【重要】的情况：

• 包含"紧急"、"关键"、"重要"、"bug"、"修复"等词
• 阻塞其他任务的核心问题
• 用户明确说是高优先级

放入【Todo】的情况：

• 常规开发任务
• 学习类任务
• 不紧急的优化任务

不确定时询问：

这个任务应该放哪个区域？
1. 重要 - 高优先级
2. Todo - 普通任务

基本操作

添加任务

添加任务: 完成用户登录功能
添加重要任务: 修复支付bug
新任务: 学习Rust异步编程

推理后添加的示例：

用户: "优化性能"

AI: 性能优化是个大任务。具体要优化：
1. 数据库查询？
2. 前端渲染？
3. API响应时间？
4. 还是整体架构？

请明确一下，我会帮你拆分成具体任务。

---

用户: "数据库查询太慢"

AI: 明白了。这个任务放【重要】还是【Todo】？

用户: 重要

AI: 已添加到【重要】：
- [ ] 优化数据库查询性能

完成任务

完成任务: 完成用户登录功能
done: 修复支付bug

完成时自动添加日期戳并移动到 Finish 区：

- [x] 完成用户登录功能 ✅ 2026-01-19

移动任务

移到重要: 优化数据库查询
移到todo: 学习Rust

查看任务

查看所有任务
查看重要任务
查看未完成任务

删除任务

删除任务: 过期的任务

最佳实践

任务描述

✅ 好的任务：

• "实现用户登录API（POST /api/login）"
• "修复支付页面在iOS上的崩溃"
• "编写用户模块的单元测试（覆盖率>80%）"

❌ 差的任务：

• "写代码"
• "做优化"
• "处理问题"

优先级判断

重要（重要区）：

• Bug修复（特别是线上问题）
• 阻塞其他任务的关键点
• 紧急截止日期的任务
• 核心功能实现

普通（Todo区）：

• 新功能开发
• 代码重构
• 文档编写
• 学习研究

使用场景示例

详见 examples/ 目录中的完整对话示例：

• clear-task.md - 清晰任务直接添加
• vague-task.md - 模糊任务询问细节
• complex-task.md - 复杂任务建议拆分
• priority-judgment.md - 自动判断优先级

注意事项

1. 必须推理: 不要机械地添加任务，先思考任务是否清晰
2. 主动询问: 不确定就问，不要猜测
3. 保持简单: 任务描述应该一行能说完
4. 具体可执行: 每个任务都应该能直接开始做
5. 适度拆分: 不要拆得太细，也不要太粗
6. 去重检查: 添加前检查是否已存在相同或相似任务

扩展阅读

• 命令参考: 见 references/commands.md
• 技术实现: 见 references/implementation.md
• 工具集成: 见 references/integrations.md

核心理念: 在添加任务前先思考，确保每个任务都是清晰、具体、可执行的。不要机械执行，要智能推理。