SuperAPI AI 工具集

001-jeremy-taskwarrior-integration

办公与效率

查看项目

更新于 10-23 18:44

技能介绍

用途

该技能用于为所有编码活动强制实施统一的 Taskwarrior 集成协议,使每一项工作都先被拆解为可跟踪的任务,并在任务生命周期中记录优先级、截止日期、标签、依赖关系、决策注释和工时。其核心规则是:在 Taskwarrior 任务创建并启动之前,不编写任何代码。

主要能力

  • 任务拆解:简单请求创建单个任务;复杂请求创建父任务与带 depends 依赖的子任务。每个任务要求设置 project、priority(H/M/L)、due 和至少两个相关标签。
  • 任务激活与计时:通过 task <ID> start 启动任务,并配合 Timewarrior 自动记录时间;可用 task active 和 timew 验证当前跟踪状态。
  • 实施过程中的记录:使用 task <ID> annotate 记录关键决策或阻塞原因;遇到阻塞时停止任务并标记 +blocked;范围变化时修改任务描述或新增依赖子任务。
  • 任务完成与汇报:使用 task <ID> done 完成任务,结合 timew summary :ids 查看工时,使用 task next 查看后续任务或已解锁的依赖任务。
  • 优先级与标签体系:提供 H/M/L 优先级判定指引,以及功能、缺陷修复、重构、测试、文档、部署、安全、性能、调试、维护、自动化、基础设施等标签分类,并含技术标签与状态标签。
  • 特殊场景处理:覆盖任务中途范围变更、阻塞处理、跨会话多阶段工作、以及基于用户已有任务继续工作等场景。

使用方式

当用户提及 taskwarrior、task warrior、tw,或提出创建任务、跟踪工作、加入 Taskwarrior、开始任务、任务管理、时间跟踪等请求时,技能自动激活。典型流程为:

  1. 创建任务,例如: task add "Build FastAPI authentication system" project:WebDev priority:H due:2days +fastapi +auth +security +backend
  2. 启动任务并确认计时: task 1 start timew
  3. 实施代码,并用 task <ID> annotate 记录决策或阻塞。
  4. 完成任务并输出工时: task 1 done timew summary :ids

若用户直接要求写代码而未提及 Taskwarrior,技能要求先主动创建任务、启动任务,再进入实现。

适用场景

  • 需要把编码工作与任务管理、时间统计统一起来的个人开发者或团队。
  • 多步骤、带依赖关系的复杂项目,例如带认证、数据库、文档和部署的 API 开发。
  • 调试排查类工作,需要记录根因、解决方案等调查过程。
  • 周期性维护任务,例如每周清理 Docker 镜像,可使用 recur 属性自动生成后续实例。
  • 跨多次对话延续的项目工作,可按项目查询待办并创建关联任务。

限制与前提

  • 需要已安装并配置 Taskwarrior;时间统计依赖 Timewarrior,并在两者完成集成配置后才会自动计时。
  • 该技能强调强制流程:未创建并启动任务前不写代码,这可能不适合不希望引入任务管理开销的轻量场景。
  • 资料未提供具体的安装命令、版本要求、平台支持范围、收费信息或与其他工具的官方集成细节,这些内容暂未提供。
  • 资料中提及可与 VS Code Taskwarrior 扩展、CI/CD、Git 工作流、团队共享服务器、报表工具等配合,但未给出具体配置步骤。