topydo

topydo 是一款面向 todo.txt 格式的高级命令行任务管理工具，本 Skill 为其完整的使用文档指南。核心用法涵盖：通过 topydo add 创建带优先级(A-Z)、项目(+Project)、上下文(@Context)、截止日期(due:)、开始日期(t:)及重复周期(rec:)的任务；利用 topydo ls 配合多维度过滤器（项目、上下文、优先级范围、日期表达式）快速检索任务；借助 topydo dep 建立任务间依赖关系与层级结构；通过 topydo do/del/pri/tag 完成状态流转与属性变更。

显著优点包括：纯文本格式确保数据永久可读与版本控制友好；依赖管理、重要性排序(importance)、重复任务等高级功能超越基础 todo.txt 工具；跨平台支持(macOS/Linux/Windows)与多种安装方式；配置灵活，支持自定义排序规则与输出格式。潜在局限性在于：CLI 交互对非技术用户存在学习门槛；缺乏原生云端同步，多设备协作需借助第三方同步盘；无图形界面，可视化依赖需额外安装 graphviz。

适合目标群体为：开发者、技术从业者等偏好终端工作流的用户；追求数据主权、拒绝 SaaS 锁定的人群；需要复杂任务关系管理(GTD 方法实践者)但抗拒重型项目管理软件的用户。使用风险方面：作为纯文档型 Skill 本身无代码执行风险，但用户需自行通过 pip/brew 安装 topydo 工具，建议验证 PyPI/官方仓库来源；todo.txt 文件路径配置错误可能导致数据丢失；依赖管理功能若配置不当可能产生循环依赖或任务隐藏，建议启用 identifiers = text 确保 ID 稳定性。

核心用法

topydo 是一款基于 Python 开发的开源命令行任务管理工具，遵循 todo.txt 纯文本格式标准。它通过扩展语法支持优先级(A-Z)、项目(+Project)、上下文(@Context)、截止日期(due:)、开始日期(t:)、递归(rec:)和任务依赖(before:/partof:)等高级功能。用户可通过 topydo add 添加任务，topydo ls 配合丰富过滤条件查询，topydo do 标记完成，并支持 JSON 输出、依赖关系可视化等扩展能力。

显著优点

功能丰富且标准兼容：在保持 todo.txt 人类可读格式的同时，增加了依赖管理、递归任务、相对日期解析等企业级功能，满足复杂项目管理需求。跨平台支持：通过 Homebrew、pip、apt 多种渠道安装，覆盖 macOS、Linux、Windows 全平台。查询能力强大：支持按项目、上下文、优先级范围、截止日期区间等多维度过滤，并可按重要性、截止日期等字段自定义排序。纯本地运行：所有数据存储于本地文本文件，无需网络连接，隐私完全自主可控。

潜在局限

学习曲线较陡：丰富的扩展语法和过滤表达式对新手不够友好，需要一定时间掌握 todo.txt 格式规范。依赖外部工具：依赖关系可视化需要额外安装 graphviz，部分高级功能依赖 Python 生态。无原生 GUI：纯 CLI 设计对偏好图形界面的用户不够友好，需配合终端或第三方工具使用。移动端支持有限：虽有第三方客户端支持 todo.txt 格式，但 topydo 特有扩展语法可能无法完全兼容。

适合人群

适合程序员、开发者、技术写作者等习惯命令行工作流的用户；偏好纯文本、可版本控制任务数据的隐私敏感用户；需要复杂任务依赖管理和项目分组的中小团队项目管理场景；以及追求工具极简哲学、反感复杂 SaaS 工具的技术爱好者。

常规风险

本 Skill 为纯文档型指引，自身无代码执行风险。用户在实际安装运行 topydo CLI 时需注意：通过 pip 安装会引入 Python 依赖包，建议在虚拟环境中操作；sudo apt 系统级安装可能影响系统 Python 环境；任务文件明文存储需自行做好备份和权限管理。