Beads vs Markdown TODO:AI Agent 长任务还该写 TODO.md 吗
最后更新:2026-05-08
📋 一句话结论
小任务继续用 Markdown TODO;一旦任务超过 1 天、超过 5 个子任务或需要多个 agent 接力,就应该升级到 Beads 这类结构化任务图。
| 对比维度 | Beads | Markdown TODO | 胜者 |
|---|---|---|---|
| 轻量程度 | 需要安装和初始化 | 新建一个 Markdown 文件即可 | ✅ Markdown TODO |
| 结构化 | issue、状态、依赖更结构化 | 靠人工格式约定 | ✅ Beads |
| 长任务恢复 | ready/blocking/dependency 更适合恢复 | agent 需要重新读全文并推断 | ✅ Beads |
| Git 友好 | 仓库内任务状态,可同步 | 纯文本天然 Git 友好 | 🤝 平手 |
| 最佳场景 | 多步骤、多依赖、跨 session | 一次性小任务、简单清单 | 🤝 平手 |
轻量程度 Markdown TODO 胜
Beads 需要安装和初始化
Markdown TODO 新建一个 Markdown 文件即可
Markdown 最轻
结构化 Beads 胜
Beads issue、状态、依赖更结构化
Markdown TODO 靠人工格式约定
Beads 更不容易散
长任务恢复 Beads 胜
Beads ready/blocking/dependency 更适合恢复
Markdown TODO agent 需要重新读全文并推断
长周期 Beads 优势明显
Git 友好 平手
Beads 仓库内任务状态,可同步
Markdown TODO 纯文本天然 Git 友好
两者都能进仓库
最佳场景 平手
Beads 多步骤、多依赖、跨 session
Markdown TODO 一次性小任务、简单清单
按复杂度选择
📊 详细分析
轻量程度 Markdown TODO
Markdown 最轻
结构化 Beads
Beads 更不容易散
长任务恢复 Beads
长周期 Beads 优势明显
Git 友好 平手
两者都能进仓库
最佳场景 平手
按复杂度选择