SuperAPI AI 工具集

time-tracker

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

用途:把 AI 智能体变成时间追踪伙伴,记录工作会话、发现时间分配规律,帮助保护最重要的资源——时间。

主要能力:以项目、类别和备注记录工作会话;分别统计计费与非计费小时;生成每日摘要和每周报告;监控深度工作连续时段(不受打断的专注块);按项目或客户计算每小时收入;当时间分配偏离既定目标时给出提示;可与 financial-tracker、project-tracker、goal-tracker 集成。

使用方式:先在工作区创建 time-state.json,包含 config(work_day_hours、deep_work_threshold_minutes、billable_rate_default、week_start、timezone)、active_session、today、weekly_totals、projects 和 categories 等字段;再在 AGENTS.md 中加入常驻指令,例如听到“start timer”或“starting [task]”时记录会话开始,听到“stop timer”或“done with [task]”时记录结束时间并更新总计,在一天结束或被询问时生成每日时间摘要,若超过 3 小时无记录则提示可能存在未追踪时间。可选在 HEARTBEAT.md 中设置每日收尾提醒和每周五的周报提醒。常用命令包括 start timer、stop timer、log time、time summary today、weekly time report、billable hours for [client/project] this [week/month]、time by project、revenue per hour analysis、add time-tracking project、set weekly time goals 等。会话记录字段含 id、date、start、end、duration_minutes、project、category、billable、rate、notes、deep_work、interruptions。

适用场景:独立经营者的日常时间记录、按客户/项目统计可开票小时、深度工作复盘、周度目标检查与月度发票准备。可自定义每项目计费费率、非按小时计费类型、深度工作阈值和是否追踪周末。

限制:所有时间数据保存在本地工作区,技能不会自动发送报告或发票,分享均需用户主动发起;日志时间以录入时的本地时间存储,时区配置仅决定报告时区;并行工作时建议事后补录而非使用开始/停止计时。该技能免费开源,采用 CC-BY-NC-4.0 许可。官方未提供更多收费、平台或效果细节。