task-tracking-dots

使用 Dots 跟踪任务

Dots 是一款轻量级任务跟踪工具，用于管理跨会话的工作。使用 dot CLI 跟踪工作项、依赖关系和完成原因。

何时使用此技能

在需要以下操作时使用此技能：

• 跨会话跟踪工作项
• 管理任务之间的依赖关系
• 记录完成原因，以便审计

预检：确保已安装 dot

运行任何工作流命令前，先检查是否有 dot CLI：

command -v dot >/dev/null 2>&1

如果找不到 dot，请安装它。

Homebrew：

brew install joelreymont/tap/dots

从源代码安装（需要 Zig 0.15+）：

git clone https://github.com/joelreymont/dots.git
cd dots
zig build -Doptimize=ReleaseSmall
cp zig-out/bin/dot ~/.local/bin/

确保 ~/.local/bin 位于 PATH 中，然后验证：

dot --version

基本会话工作流

每次会话开始时：

dot ls
dot ready

开始任何任务前：

dot on <id>

完成任何任务后：

dot off <id> -r "What was done"

绝不要让已完成的任务保持开启状态。务必附上简短原因后关闭。

---

创建 Dot

# Quick add
dot "Fix the bug"

# With priority and description
dot add "Design API" -p 1 -d "Details"

# As child of another dot
dot add "Subtask" -P dots-1

# Depends on another dot
dot add "After X" -a dots-2

优先级

级别	含义
0	紧急（立即处理）
1	高
2	中（默认）
3	低
4	待办

---

使用 Dots

dot ls              # List open dots
dot ready           # Show unblocked dots
dot show dots-1     # Show dot details
dot tree            # Show hierarchy
dot find "query"   # Search dots

工作流提醒：

• 开始新工作前，务必检查开放/就绪的 dot。
• 开始工作前，使用 dot on <id>。
• 完成后立即使用 dot off <id> -r "..."。

---

正确关闭任务

每项已完成的任务都需要填写原因。内容应简短且具体。

dot off dots-5 -r "Fixed null check in player.gd"
dot off dots-12 -r "Already implemented in previous session"
dot off dots-3 -r "Created PR #42, awaiting review"

如果发现任务已经完成，请在关闭时于原因中提供证据。

---

部分进展

如果任务只完成了一部分：

• 创建一个子任务来记录剩余工作，或者
• 创建一个依赖当前任务的后续 dot。

这样可以确保当前 dot 信息准确，并为下次会话保留上下文。

---

Dots 与 TodoWrite

• Dots：多步骤工作、可能跨会话的任务，或存在依赖关系的工作。
• TodoWrite：面向用户展示的小型单会话检查清单。

当工作改变了仓库内容时，立即更新相应的 dot。