前言¶
自学或备考时，常见痛点不是「不知道番茄工作法」，而是计划写得笼统、休息节奏随意、学完后也说不清今天有效学了多久。手机番茄钟 App 能倒计时，但很少结合你的科目、专注能力和环境，在对话里帮你拆任务、记时长、给改进建议。
下面介绍 SkillHub 社区 Skill「学习专注计时」（@user_70c2f807/study-focus-timer）。它把番茄钟规划、专注建议、手动汇报后的时长汇总写进 Agent 的 SKILL.md 工作流，适合在 Cursor、Claude Code 等支持 Skills 的客户端里，用自然语言驱动学习安排。
这是什么¶
「学习专注计时」是面向 学习场景 的提示词型 Skill（版本 1.0.1），发布者为 user_70c2f807，来源为 community，在 SkillHub 上归类为 education。坐标为 @user_70c2f807/study-focus-timer；页面标注 requires_api_key=false，安装后无需额外 API Key。
定位：基于番茄工作法，帮助用户规划学习时段、制定专注与休息节奏，在用户主动汇报的前提下记录学习时长并做效率分析。官方 SKILL 明确 不适用于 工作专注、冥想、睡眠等场景；与工作类专注工具或项目管理 Skill 应区分开。
核心功能¶
以下能力均来自官方 SKILL.md，Agent 在匹配到学习计时相关意图后按步骤执行。
- 番茄钟计划：根据目标时长分配番茄钟数量，采用 25+5 或 50+10 等节奏，并安排长休息节点。
- 需求澄清：确认科目、目标时长、连续专注能力、学习环境（在家/图书馆等）。
- 专注与防分心建议：例如材料提前准备、走神处理、任务拆解等（以对话建议为主，非设备控制）。
- 手动记录与汇总：用户学完主动说明后，记录时长、完成率与效率评估；支持「今天学了多久」类汇总。
- 结构化输出：学习计划模板含目标时长、番茄钟列表、每项任务与休息说明，以及专注建议。
- 异常与 FAQ：目标不明、单次过长（超 5 小时）、频繁走神、科目不明等场景有固定引导话术；FAQ 覆盖番茄时长可调、休息是否刷手机、中断处理、科目排序、每日番茄数量等。
安装与启用¶
安装流程以 SkillHub 官方说明为准：先确保本机有 skillhub CLI，再将 Skill 安装到 当前 Agent 能识别的 skills 目录（须使用 --dir，否则默认 ./skills/ 可能不被加载）。
1、检查 CLI：
command -v skillhub && skillhub --version
未安装时可按官方文档执行（完整安装或仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill（将 <skills 目录> 换成你当前客户端的路径）：
skillhub install @user_70c2f807/study-focus-timer --dir <skills 目录>
常见路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可把下面提示词发给 Agent，让其按 https://skillhub.cn/install/skillhub.md 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_70c2f807/study-focus-timer`。
安装后按各客户端要求刷新或重启，使 Skill 生效。SkillHub 页面统计（截至抓取）：评分 100000，下载 918 次。
典型用法¶
官方在 SKILL.md 中给出了触发语与 Agent 行为对应关系，可直接复现。
开始一次学习
用户：我要开始学习了
→ Agent 了解科目与时长目标，制定番茄钟计划
带时长与科目的规划
用户：学习2小时数学
→ 规划 4 个 25 分钟番茄钟及休息，并给出专注建议
学完后记录
用户：我学完了，记录一下
→ 记录学习时长，做效率评估与鼓励
当日汇总
用户：今天学了多久？
→ 汇总今日各科学习时长与番茄钟完成情况
专注困扰
用户：我老是走神怎么办？
→ 分析分心原因并给出针对性技巧
输出示例遵循「学习计划 | 科目」结构：目标时长、番茄钟数、预计完成时间、逐段任务与休息、专注建议，并提示用户自行设好物理计时器再开始。
适用场景与注意¶
适合谁
- 需要在对话里快速拆学习块、统一休息节奏，又不想每次手写计划的人。
- 愿意在番茄结束后 主动汇报 进度，让 Agent 做当日汇总与简单复盘的学习者。
重要限制（官方要求提前告知用户）
| 限制 | 说明 |
|---|---|
| 无法实时计时 | 不能后台倒计时，需配合手机、手表等自行计时 |
| 无法强制专注 | 仅规划与建议，不能屏蔽通知或锁屏 |
| 记录需手动更新 | 时长依赖用户告知，无法自动检测是否在学 |
| 对话内临时记录 | 学习记录仅在当前对话中保存，不持久化习惯数据；长期统计需另用 App 或工具 |
不适用场景（官方列举）
- 需要实时计时提醒 → 使用手机番茄钟 App
- 强制屏蔽手机 → 使用专注锁屏类 App
- 长期学习数据分析 → 使用专用学习记录 App
- 工作任务管理 → 使用项目管理工具
触发关键词包括：学习计时、专注学习、番茄钟学习、study timer、focus study、pomodoro study 等；涉及 工作专注 时不应误用本 Skill。
结尾¶
「学习专注计时」把番茄钟规划、休息节奏、手动记录与汇总固化成 Agent 可执行的 SKILL 流程，适合作为学习场景下的对话式辅助，而不是替代物理计时器或自律工具。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_70c2f807/study-focus-timer
- 资源地址：https://api.skillhub.cn/user_70c2f807/study-focus-timer
