核心用法
Taskwarrior 是一款久经考验的命令行任务管理器,本 Skill 将其封装为工作区级别的任务追踪解决方案。用户无需手动配置全局 ~/.taskrc,Skill 自动在 <workspace>/.openclaw/taskwarrior/ 下初始化独立的数据目录和配置文件,实现项目间数据完全隔离。
主要功能
| 功能 | 说明 |
|------|------|
| `add` | 创建新任务,支持项目、标签、截止日期、优先级 |
| `list` | 多维度任务视图(全部/按项目/按标签/待办/已完成) |
| `modify` | 编辑任务属性、添加注释 |
| `done` | 标记任务完成 |
| `projects/tags` | 项目分组与标签体系管理 |
工作流程
1. 自动检测:执行 task --version 验证 Taskwarrior 可用性
2. 智能安装:缺失时按 references/install.md 指引自动安装(需用户授权)
3. 初始化配置:生成工作区专属 taskrc 和数据目录
4. 安全执行:封装常用命令,过滤危险操作
5. 结果验证:确认操作成功并返回结构化反馈
显著优点
- 零配置即用:自动处理路径解析(支持
OPENCLAW_WORKSPACE/WORKSPACE/PROJECT_DIR/REPO_ROOT等环境变量回退) - 数据隔离:每个工作区独立存储,避免任务数据混杂
- 成熟后端:依托 Taskwarrior 2.6+ 的稳定性和丰富生态
- 安全意识:默认禁止
delete/purge等破坏性操作,防止误删
潜在局限
- 依赖外部二进制:需系统预装或允许自动安装 Taskwarrior
- 无图形界面:纯命令行交互,对非技术用户存在门槛
- 同步限制:未集成云端同步,跨设备需手动迁移数据目录
- 功能裁剪:仅暴露常用子集,高级功能(如 hooks、自定义报表)需手动操作
适合人群
开发者、技术写作者、运维工程师等习惯命令行工作流,需要为每个代码仓库或项目维护独立任务列表的用户。特别适合与 Git 工作流结合,实现"代码+任务"同目录管理。
常规风险
- 路径污染:自动创建工作区子目录,需确保
.openclaw/taskwarrior/不被意外提交到版本控制(建议配合.gitignore模板) - 数据备份:本地存储无自动备份机制,重要任务需自行归档
- 版本兼容性:Taskwarrior 3.0+ 数据格式变更可能导致迁移成本