"这个任务两小时够了"——Kanban 板现在会在开工时告诉你 P50 和 P90


Kanban 板上有一张卡片,描述写得挺清楚,末尾一句“预计 2 小时”。你把它丢给 worker,去干别的。三小时后它还在跑,六小时后它在跑测试,九小时后你终于拿到了 PR。

下次再遇到同类任务,你还是写“预计 2 小时”。不是因为你不长记性,而是因为没有任何地方记着“上次这类任务实际用了九小时”。估算这件事最缺的从来不是方法,是反馈。

Epoch 这个社区插件解决的正是这一段:给 Kanban 板加上“估算—实际—校准”的闭环。

它在 Kanban 上到底做了什么

三条动作,都发生在你已经熟悉的时机上:

  1. worker 认领任务的那一刻,插件发一条蒙特卡洛估算,作为任务评论贴到卡片上。给的是 P50 和 P90(还会带上 P80/P95),不是一句“大概两小时”。
  2. 这一轮跑完之后,插件把实际墙钟小时数写回 Epoch 自己的账本,标记来源是 auto_wallclock——意思是这是测量出来的,不是人填的。
  3. 下一次估算就用这些实际值来校准。跑得越多,偏差越小。

它挂的是两个 Kanban 钩子:kanban_task_claimed 和 kanban_task_completed。也就是说,你不需要改自己的任务流程,只要插件装着、板子在用,估算就自动贴在卡片上。

另外它还注册了一个 epoch_estimate 工具和一个 /epoch 斜杠命令,需要单独问一次估算时可以直接调用。

装之前先看清三件事

第一,它是社区插件,不是官方内置。 目录里 tier 是 community,维护者是 KyaniteLabs,requires_hermes 写的是 >=0.21.6。

第二,它需要 Node 22+,而且第一次跑要连 npm。 插件本身是个薄壳,真正的估算器是 npx -y @kyanitelabs/[email protected] 这个子进程。第一次运行时它会从 npm 下载 Epoch 和它的依赖。

第三,任务标题会被传给这个本地 CLI。 只有标题的前 80 个字符,加上你写的三点估算提示。数据不出本机,但“不出本机”和“不传任何东西”是两件事,值得知道。

安装就是一条命令:

hermes plugins install epoch

装完之后用 hermes plugins list 确认它出现在列表里、状态是启用。插件在下一个加载周期生效:如果你刚装完就在已经跑着的会话里找它的工具,看不到的话重启一次网关最省事。

怎么写一张“能被校准”的任务卡

默认情况下它走参考类估算(reference class)——拿历史同类任务的数据给一个范围。这个默认值在头几次就有用,因为 Epoch 自带一份打包的参考数据库。

但真正让估算变准的,是你在任务里显式给一个三点区间:

重构计费模块的金额计算,去掉浮点误差

epoch: 2/4/10h

2/4/10h 是最乐观 / 最可能 / 最悲观。有了这三个数,蒙特卡洛就有分布可采样,P50 和 P90 才有意义。没有它,插件只能用参考类估算凑一个范围——能用,但不如你自己给的准。

写的时候注意单位:h 是小时。区间别写成“2-10 小时”这种含糊表达,插件认的是斜杠分隔的三个数字。

它刻意做窄的地方

这类“给 agent 记账”的插件最容易越界,Epoch 在披露里把边界写得相当细,其中几条值得单独说:

  • 子进程的环境是被清洗过的:只放行 PATH、HOME、locale、临时目录,以及 Node/npm 相关的缓存、registry、CA 和代理变量。父进程的环境、API key、Hermes 的 secret 不会被子进程看到。
  • 遥测强制关闭:插件每次调用子进程都设置 EPOCH_TELEMETRY=0。Epoch 单独使用时遥测是可选开启的,但插件不会替你打开。
  • 数据落在 HERMES_HOME/plugin-data/epoch/:估算、实际值、运行绑定都在这里,多个 profile 共享同一份账本。
  • /epoch 是个受限的透传口:它把其他子命令交给 Epoch,但拒绝 serve、self-improve 和任何改遥测/改数据的操作;在网关平台上还拒绝写账本的子命令,除非你显式打开 allow_write_slash_on_gateway。
  • 卡片上的评论只是显示:估算和完成记录靠“运行绑定”对齐,靠的是账本旁边那份映射。所以就算有人在评论里伪造一个标记,也不会把记录引到别的运行上。

钩子的工作跑在短命的后台线程上(并且带着 contextvars 的上下文拷贝),所以它不会拖慢 worker 的启动。进程如果在一件事做完之前就退出,插件有一个 profile 本地的 outbox,下次加载时会补跑。

三个必须知道的坑

一、12 小时的记录上限。 写回账本之前有一道 sanity gate:只接受 0.05 到 12 小时之间、并且不超过估算 10 倍的运行。设计意图很清楚——挡住明显错的测量值。但它也意味着:一个跑了 14 小时的任务,这次的实际耗时不会被记进账本。如果你做的多是长任务,这个上限会让校准数据变少。

二、第一次跑可能卡在 npm 上。 依赖是第一次运行时下载的。如果你的 npm 配了 min-release-age 之类的策略,钉住的那个版本可能还没“够年龄”,于是下载被拒。插件的处理是把任务留在队列里重试,不会报错退出——所以症状是“估算迟迟不出现”,而不是一条明确的错误。第一次装完,最好手动触发一次确认它能下载。

三、它不认识“你心里那个 2 小时”。 三点区间是你给的,插件只能基于它采样。如果你习惯性把最可能值写小(人都这样),P50 也会跟着偏小——只是这次的偏差会被记录、被下次估算吸收。这算是它比人强的地方,但也意味着头几次的估算别太当真。

适合谁,不适合谁

适合:任务类型重复、卡片上有明确完成定义、愿意花十秒写三点区间的团队。跑上两三周之后,“这类任务一般多久”就不再靠记忆和感觉了。

不适合:一次性探索任务(没有参考类可言)、超过 12 小时的长期项目(记录会被 sanity gate 挡掉)、以及完全不能连 npm 的离线环境。

顺便说一句它和 Hermes 自己那套 Kanban 流程的关系:看板的任务生命周期、review 与回收机制是 Hermes 内置的,Epoch 只是挂在认领/完成两个钩子上加一层估算。想先搞清楚看板本身怎么跑,可以看这篇 Kanban review 生命周期;插件目录里还有什么值得装的,这篇批量收录的解读把准入规则讲清楚了。

什么时候能用上

这个条目是 2026 年 11 月 8 日合并进插件目录的(PR #149757),版本 0.7.0,main 上已经有这条目录记录。用稳定版的用户只要 requires_hermes 满足(>=0.21.6)就能装——插件目录是运行时读取的,不需要等 Hermes 发新版本。

一句话总结

估算失准的根因不是方法不够高级,是没人把实际耗时喂回去。Epoch 在 Kanban 的“认领”和“完成”两个时刻各插一手:开工时贴一条带 P50/P90 的蒙特卡洛估算,收工时把真实小时数写回账本。代价是第一次要连 npm、超过 12 小时的运行不会被记录;收益是从第三周开始,你卡片上那个数字终于开始接近现实。