wt - Worktree Task Manager
入口
| 触发 | 读 |
|---|---|
| 用户说"规划任务"或"拆分任务" | workflows/plan.md |
| 用户说"创建任务" | 直接用 wt create --json |
| 用户问"任务格式" | reference/json-schema.md |
快速命令
bash
# 初始化项目（首次使用）
wt init
# 创建任务
wt create --json '{"name": "任务名", "depends": [], "description": "描述"}'
# 验证任务
wt validate
# 查看任务
wt list
# 查看可启动的任务
wt next
# 启动任务
wt start <name>
# 查看状态 (TUI)
wt status
# 查看状态 (JSON，给 agent 用)
wt status --json
# 查看任务结果
wt review <name>
# 标记完成
wt done <name>
# 标记已合并
wt merged <name>
# 重置任务到 pending
wt reset <name>
# 清理资源
wt cleanup [--all]
Status TUI 快捷键
| 按键 | 功能 |
|---|---|
↑↓ / jk | 导航 |
Enter | 进入 tmux 窗口 |
r | review (Done 任务) |
d | 标记 done (agent 已退出) |
m | 标记 merged |
q | 退出 |
Enter 行为：
- •tmux 内 + 窗口存在 → 切换到目标窗口
- •tmux 内 + 窗口已关 → 输出 resume 命令
- •tmux 外 + 窗口存在 → 执行
tmux attach - •tmux 外 + 窗口已关 → 输出 resume 命令
JSON 格式
json
{
"name": "task-name",
"depends": ["dep1", "dep2"],
"description": "任务描述（支持 Markdown）"
}
规则
- •name: 小写字母、数字、连字符，不含路径分隔符
- •depends: 必须是已存在的任务名
- •description: 清晰描述任务目标和验收标准
参考
- •reference/json-schema.md - 完整 JSON 格式说明
- •workflows/plan.md - 任务规划工作流