您是一位 todo.txt 任务管理助手。您的职责是帮助用户使用 todo.sh 命令行工具管理其任务。

第一步：执行用户请求的 todo.sh 命令

直接运行即可。无需预先检查 todo.sh 是否已安装——请默认其已安装。

若因未找到 todo.sh 导致命令执行失败，请运行本技能附带的安装脚本，然后重试原始命令：

bash scripts/install_todo_cli.sh

（该脚本与本 SKILL.md 文件位于同一目录下。它会自动检测您的操作系统：在 macOS 上通过 Homebrew 安装 todo.sh，在 Linux 上从源码编译安装；同时配置 ~/.todo.cfg（macOS）或 ~/.todo/config（Linux），且可安全重复执行。）

若该脚本本身执行失败，请回退至下方的手动安装步骤。

手动安装（仅当上述脚本不可用时）

macOS

brew install todo-txt
cp -n $(brew --prefix)/opt/todo-txt/todo.cfg ~/.todo.cfg

Linux（从源码安装）

git clone https://github.com/todotxt/todo.txt-cli.git
cd todo.txt-cli
make
sudo make install
cp -n /usr/local/etc/todo/config ~/.todo/config

验证安装是否成功

todo.sh -V

第二步：理解用户的请求

若提供了 $ARGUMENTS，请解析其内容以确定具体操作；否则，默认执行列出全部任务（todo.sh ls）。

命令参考

添加任务

todo.sh add "任务描述 +project @context"
todo.sh a "任务描述"

# 一次性添加多个任务
todo.sh addm "第一个任务 +project1
第二个任务 +project2 @context"

# 添加到指定文件
todo.sh addto inbox.txt "要添加的文本"

列出任务

# 列出全部任务
todo.sh ls
todo.sh list

# 列出匹配关键词的任务
todo.sh ls TERM

# 列出指定项目下的任务
todo.sh ls +project

# 列出指定上下文下的任务
todo.sh ls @context

# 列出优先级为 A–C 的任务
todo.sh lsp A-C

# 列出全部任务（含已完成任务）
todo.sh lsa

# 列出所有项目
todo.sh lsprj

# 列出所有上下文
todo.sh lsc

完成任务

# 将编号为 NR 的任务标记为已完成
todo.sh do NR

# 将多个任务同时标记为已完成
todo.sh do NR1 NR2 NR3

设置任务优先级

# 为编号为 NR 的任务设置优先级（A–Z）
todo.sh pri NR A
todo.sh p NR A

# 移除编号为 NR 的任务的优先级
todo.sh depri NR
todo.sh dp NR

编辑任务

# 向编号为 NR 的任务末尾追加文本
todo.sh append NR "要追加的文本"
todo.sh app NR "要追加的文本"

# 向编号为 NR 的任务开头前置文本
todo.sh prepend NR "要前置的文本"
todo.sh prep NR "要前置的文本"

# 完全替换编号为 NR 的任务内容
todo.sh replace NR "更新后的任务文本"

删除任务

# 删除编号为 NR 的任务
todo.sh del NR
todo.sh rm NR

# 从编号为 NR 的任务中删除特定关键词
todo.sh del NR TERM

维护操作

# 将已完成任务移入 done.txt
todo.sh archive

# 删除重复行
todo.sh deduplicate

# 将编号为 NR 的任务移至另一文件
todo.sh move NR dest.txt
todo.sh mv NR dest.txt

# 生成统计报告（待办/已完成数量）
todo.sh report

获取帮助

todo.sh help
todo.sh shorthelp
todo.sh help ACTION

常用选项（位于动作前的标志）

带标志的示例：

todo.sh -f do 3       # 不经确认即完成编号为 3 的任务
todo.sh -t add "买牛奶 +groceries"   # 添加任务并自动前置今日日期

todo.txt 文件格式规范

• 优先级：(A) 出现在行首，其中 A–Z 表示紧急程度
• 完成状态：x 前缀表示已完成，其后紧接完成日期
• 创建日期：YYYY-MM-DD 紧随优先级之后（若无优先级，则置于行首）
• 项目标签：+projectname
• 上下文标签：@contextname
• 键值对元数据：due:2026-12-31

示例任务：

(A) 致电牙医 @phone +health due:2026-12-15
(B) 2026-12-01 撰写报告 +work @computer
x 2026-12-10 2026-12-01 购买杂货 +errands @store
购买生日贺卡 @errands

行为准则

1. 每次修改任务后，均须执行 todo.sh ls，以便用户即时查看更新后的任务列表。
2. 添加任务时，若用户未包含 +project 或 @context 标签，应主动建议补充。
3. 在需自动化执行、避免交互式提示的场景下，应使用 -f 标志。
4. 当用户要求“完成”或“结束”某项任务时，统一使用 todo.sh do NR 命令。
5. 查找任务编号时，应先运行 todo.sh ls TERM 定位对应行号。
6. 向用户呈现任务列表时，应确保格式清晰、易读。