wt

name: wt description: Worktree 任务管理。帮助用户规划、创建和管理并行开发任务。当用户说"规划任务"、"拆分任务"、"创建 wt 任务"时触发。

wt - Worktree Task Manager

入口

快速命令

# 初始化项目（首次使用）
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 快捷键

Enter 行为：

• tmux 内 + 窗口存在 → 切换到目标窗口
• tmux 内 + 窗口已关 → 输出 resume 命令
• tmux 外 + 窗口存在 → 执行 tmux attach
• tmux 外 + 窗口已关 → 输出 resume 命令

JSON 格式

{
  "name": "task-name",
  "depends": ["dep1", "dep2"],
  "description": "任务描述（支持 Markdown）"
}

规则

1. name: 小写字母、数字、连字符，不含路径分隔符
2. depends: 必须是已存在的任务名
3. description: 清晰描述任务目标和验收标准

参考

• reference/json-schema.md - 完整 JSON 格式说明
• workflows/plan.md - 任务规划工作流