待办任务管理器

技能简介

topydo 是一款基于 todo.txt 格式的命令行任务管理工具，支持优先级标记、项目分类、上下文标签、截止日期、重复规则以及任务依赖关系。

业务背景

帮助个人及小团队用纯文本方式管理任务，无需依赖云端服务或复杂软件。支持优先级、项目分类和依赖关系，适合敏捷开发中的需求拆解与进度跟踪，数据文件可版本控制，保障信息主权。

落地案例：产品经理将季度规划录入`topydo add "完成竞品分析报告 +Q3Planning @research due:2024-08-15"`，并标记优先级为A。开发任务设置依赖关系：：`topydo add "上线用户中心模块 +UserCenter @dev"`后执行`topydo dep 2 on 1`确保设计稿完成后才启动开发。每日晨会用`topydo ls`按优先级浏览待办，，`topydo do 3`快速标记完成的任务自动归档至done.txt。

能做什么

• 添加、列出、完成、删除任务
• 设置任务优先级（A-Z）、项目和上下文标签
• 管理截止日期、开始日期和重复周期
• 建立任务间的依赖与子任务关系
• 按多种条件筛选和排序任务列表
• 以 JSON 或自定义格式输出任务数据

使用说明

安装步骤：

macOS（推荐 Homebrew）：

brew install topydo

全平台 pip 安装：

pip3 install topydo

带可选功能安装：

pip3 install 'topydo[columns,prompt,ical]'

Ubuntu/Debian：

sudo apt install python3-pip && pip3 install topydo

基本用法：

添加任务：topydo add "Buy groceries"

带优先级：topydo add "(A) Urgent task"

带项目和上下文：topydo add "Write report +ProjectX @office"

带截止日期：topydo add "Submit proposal due:2025-01-15"

带重复规则：topydo add "Water plants due:sat rec:1w"

列出任务：topydo ls

按条件筛选：topydo ls +ProjectX @office due:today

完成任务：topydo do 1

设置优先级：topydo pri 1 A

修改标签：topydo tag 1 due tomorrow

配置文件路径：~/.topydo 或 ~/.config/topydo/config

输入与输出

见下方输入与输出表格。

风险提示

• 直接编辑 todo.txt 文件可能导致格式错误，建议使用命令操作
• 任务 ID 会在增删操作后变化，依赖引用需注意同步
• 重复任务生成新条目时可能产生大量历史记录
• 配置文件中路径设置错误会导致数据丢失

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/bastos/topydo/SKILL.md
来源类型：开源社区技能