tasktime 技能

面向 AI 代理的 CLI 任务计时器 —— 通过自动保存日志与可视化图表，对学习进展进行基准测试。

ClawVault 生态系统的一部分，用于 AI 代理的记忆管理。

安装

npm install -g @versatly/tasktime

快速参考

计时器命令

tasktime start "任务描述" --category coding   # 开始计时
tasktime stop --notes "我学到的内容"                # 停止并保存
tasktime status                                       # 显示当前任务
tasktime now                                          # 适用于提示词的一行命令

历史记录与搜索

tasktime history                    # 最近的任务（别名：tt ls）
tasktime history -n 20              # 最近 20 个任务
tasktime history -c coding          # 按类别筛选
tasktime search "auth"              # 全文搜索
tasktime categories                 # 列出所有类别

报告与图表

tasktime report                     # 包含图表的完整报告
tasktime report --days 30           # 过去 30 天的数据
tasktime chart --type bar           # 柱状图
tasktime chart --type spark         # 火柴图（Sparkline）
tasktime chart --type line          # 折线图

ClawVault 集成

停止时自动保存（v1.2.0+）：每个已完成任务将自动保存至 ClawVault：

tasktime start "构建 API" -c coding
# ... 执行工作 ...
tasktime stop --notes "创纪录地快速完成"
# ✅ 已完成：构建 API
# 🐘 已保存至 ClawVault              ← 自动执行！

手动同步与导出：

tasktime sync                       # 将完整报告同步至 ClawVault
tasktime sync --days 30             # 同步过去 30 天的数据
tasktime export                     # 导出为 Markdown 格式
tasktime stop --no-vault            # 对单个任务跳过自动保存

演示数据

tasktime seed                       # 注入示例数据（仅限空数据库）

AI 代理使用场景

学习效果基准测试

跟踪同类任务随时间推移所耗时长，以衡量学习进展：

tt start "实现 OAuth 流程" -c auth
# ... 执行工作 ...
tt stop --notes "使用了 passport.js，比上次快了 20 分钟"

同步至 ClawVault

将任务数据持久化存储至 AI 代理的记忆保险库中：

# 完成工作后
tasktime sync

# 或将导出内容通过管道传给 clawvault
tasktime export | clawvault store --category research --title "任务报告"

了解更多：clawvault.dev

基于类别的分析

按类别分组任务，以了解时间分配情况：

tt report --days 7
# 展示各分类的时间占比：coding、research、testing、docs 等

提示词中的快捷状态显示

将当前任务添加至 shell 提示符中：

PS1='$(tasktime now) $ '
# 显示为：⏱️ 构建 API (23m) $

数据存储

• 位置：~/.tasktime/tasks.json
• 格式：JSON（可移植、人类可读）
• 无外部依赖或数据库

相关项目

• ClawVault — AI 代理的记忆系统
• OpenClaw — AI 代理平台

别名

• tasktime → 完整命令
• tt → 短别名（功能完全相同）