SuperAPI AI Directory

pomodoro

General & other

View repository

Updated 10-16 08:43

About this skill

Pomodoro Timer

Help users manage focus time using the Pomodoro Technique, and track the number of completed pomodoros and task progress each day.

Use Cases

  • The user says "start a pomodoro" or "I want to focus for 25 minutes"
  • The user says "how many pomodoros did I complete today" or "show me my focus records"
  • The user says "help me use the Pomodoro Technique to write a paper" (combined with a specific task)

Execution Method

Data Storage

Maintain in the user data directory ~/Documents/xiaodazi/pomodoro.json:

{
  "settings": {
    "focus_minutes": 25,
    "short_break": 5,
    "long_break": 15,
    "long_break_after": 4
  },
  "today": {
    "date": "2026-02-26",
    "completed": 3,
    "total_focus_minutes": 75,
    "sessions": [
      {"task": "写论文", "start": "09:00", "end": "09:25", "completed": true},
      {"task": "写论文", "start": "09:30", "end": "09:55", "completed": true},
      {"task": "回邮件", "start": "10:15", "end": "10:40", "completed": true}
    ]
  }
}

Core Flow

Start Pomodoro:

用户:开始一个番茄钟,任务是写周报
→ 记录开始时间和任务名
→ 回复:🍅 番茄钟开始!任务:写周报,25 分钟后提醒你休息。
→ 通过 scheduled-tasks 或系统通知在 25 分钟后提醒

Pomodoro Completed:

→ 发送通知:🍅 番茄完成!休息 5 分钟吧。
→ 记录完成,更新计数
→ 每 4 个番茄后建议长休息(15 分钟)

View Records:

用户:今天的番茄钟情况
→ 今日已完成 5 个番茄(125 分钟)
→ 任务分布:写论文 3个 | 回邮件 1个 | 代码审查 1个

Notification Method

Call the corresponding notification skill based on the platform:

  • macOS → macos-notification
  • Windows → windows-notification
  • Linux → linux-notification

Output Specifications

  • Give a concise confirmation at the start, without interrupting the user's train of thought
  • Give positive feedback + rest suggestions upon completion
  • Use a table to display the task distribution in the daily report
  • Encourage but do not pressure; do not criticize when a pomodoro is interrupted