用途:track 是一个控制台原生的可计费工时追踪技能,作为 bin/track.sh 的安全调用包装层,把 /track:* 斜杠命令翻译成对应的 Bash 调用。账本逻辑、加锁、原子写入、git 提交、jq 计算与错误信息都在 bin/track.sh 中,技能层不重复实现。
主要能力与用法:支持以下子命令,调度脚本位于 ${CLAUDE_PLUGIN_ROOT}/bin/track.sh,若该变量未设置则回退到由 SKILL.md 位置推断的插件根目录下同一路径。
- /track:start <client> [--at HH:MM | --ago <duration>]:开始计时;客户名限字母数字、短横线与下划线。
- /track:stop [--at HH:MM | --ago <duration>] [note...]:结束计时;备注必须通过 stdin(printf '%s' "<NOTE>" | ...)传入,不作为参数,以避免 shell 元字符解释;--at/--ago 只在前导标志位置生效。
- /track:pause [--at HH:MM | --ago <duration>]:暂停,不带位置参数。
- /track:resume [--at HH:MM | --ago <duration>]:恢复,不带位置参数。
- /track:status:查看状态,无参数。
- /track:report [--week | --month YYYY-MM] [--client <name>]:生成报告,标志值由调度脚本做正则校验。
限制:调度脚本会拒绝结束早于开始、暂停时间早于开始、恢复时间早于暂停点等非法时间;若计时器已暂停或未运行,pause/resume 会被拒绝。输出应原样打印调度脚本的 stdout 与 stderr,不添加总结或改写。资料未提供安装命令、价格、平台与具体报告示例。