番茄钟技能(Pomodoro Timer)
目的
用番茄工作法把时间切成「专注 + 休息」的小块,帮助用户提高专注力、避免疲劳。本技能负责:开启计时、管理番茄周期、汇报完成情况、处理打断。
何时使用
用户出现以下意图时触发:
- 「开始一个番茄钟」
- 「帮我计时专注 25 分钟」
- 「开始休息 / 休息计时」
- 「今天要完成 X,帮我安排番茄」
- 「做了几个番茄了?」
核心规则(番茄工作法标准)
- 一个番茄 = 25 分钟专注 + 5 分钟短休息
- 每完成 4 个番茄 → 15~30 分钟长休息
- 番茄不可分割:中途不休息、不切换任务;被打断则该番茄作废
- 每个番茄关联一个明确任务,完成后划掉记录
使用流程
- 确认参数:任务名称、专注时长、是否连续多个番茄。用户未指定时使用默认值(专注 25 / 短休 5 / 长休 15)。
- 启动计时:调用
scripts/pomodoro.py开始倒计时,用法见下方。 - 汇报结果:计时结束后,简要汇报本次番茄——任务、时长、完成的番茄计数。
- 衔接下一步:主动询问是否开始下一个番茄或休息。
计时脚本用法
python scripts/pomodoro.py -m 25 -n "写周报" # 单个 25 分钟番茄
python scripts/pomodoro.py -p 4 -n "产品评审准备" # 连续 4 个番茄(自动插入短休/长休)
python scripts/pomodoro.py -m 50 -b 10 -n "深度设计" # 自定义 50/10 节奏
参数说明:
| 参数 | 说明 | 默认值 |
|---|---|---|
-m / --minutes |
专注分钟数 | 25 |
-b / --break-min |
短休息分钟数 | 5 |
--long-break |
长休息分钟数 | 15 |
-n / --name |
任务名称 | 专注 |
-p / --pomodoros |
要完成的番茄数量 | 1 |
脚本特性:实时进度条、完成/打断提示音(Windows 自动用 winsound)、Ctrl+C 可安全停止并保留「未完成」标记。
打断处理
- 用户中途要求停止/取消:终止脚本进程,将该番茄记为「未完成」,不计入完成数。
- 询问用户:是调整时长重来,还是切换任务、直接进入休息。
统计建议
将番茄计数记入当天的工作记忆文件。每日结束时汇总:
## 今日番茄统计
- 完成番茄:X 个
- 专注总时长:Y 分钟
- 任务分布:任务 A(n 个)、任务 B(m 个)
详细方法、变体节奏与打断应对策略见 references/pomodoro-method.md。