FocusFlow专注力神器-即刻进入心流!
AI帮你把散乱的待办事项拆成下一步可执行的专注单元(15-60分钟),用番茄钟记录专注与中断,自动生成专注力日报。支持工作/生活分类标签、优先级、效率复盘、今日专注趋势、优化建议等。适合多线程任务场景下的注意力管理与复盘。
skillhub install @user_5206bb12/focusflow
README 文档
4,137 字FocusFlow 专注流
把散乱待办转成“可执行下一步”,再用专注记录和日报复盘注意力流向。
数据与运行
- 数据:
~/.workbuddy/focusflow/data.json - 主脚本:
scripts/focusflow.py - 报告脚本:
scripts/report_generator.py - 用户级安装目录下的 skill 可在不同对话中使用。通常直接说“加个待办”“看任务列表”即可自动触发;需要强制指定时使用
@skill:focusflow。
核心能力
- 任务分诊台 Task Triage(任务分诊):把模糊 Todo 拆成 15–60 分钟的 Focus Unit(专注单元),每个单元包含完成边界、预计耗时、优先级和顺序。
- 任务管理:支持工作/生活标签,红黄绿优先级,截止日期,部分完成,批量完成和批量改期。
- 今日焦点与过期清理:从大量任务中选出今天最该做的 3 件事;扫描过期任务,提示完成、改期或归档。
- Session(专注记录)管理:开始/结束专注,记录中断、能量、专注评分;支持事后补录和开始时间校正。
- 复盘报告:生成 Daily Focus Brief(专注日报)、Weekly Focus Brief(专注周报)、Weekly Summary(周事项小结)和 HTML 报告。
常用命令
新增任务与任务分诊
python3 scripts/focusflow.py add-task "完成项目复盘文章" work high 3 2026-08-05
python3 scripts/focusflow.py triage T001
python3 scripts/focusflow.py list-units T001
参数:title category priority estimatepomodoros duedate(optional)。
查看任务与今日焦点
python3 scripts/focusflow.py list-tasks
python3 scripts/focusflow.py suggest
python3 scripts/focusflow.py today
python3 scripts/focusflow.py today 2026-08-03 5
python3 scripts/focusflow.py sweep
today:按过期程度、优先级、进行中状态和截止日期输出今日焦点。sweep:只读扫描过期任务,不直接修改数据;由用户决定完成、改期或归档。
完成与改期
python3 scripts/focusflow.py complete-task T001
python3 scripts/focusflow.py complete-unit T001 T001-专注单元01
python3 scripts/focusflow.py batch-complete T001 T002 T003
python3 scripts/focusflow.py batch-reschedule 2026-08-09 T004 T005
当用户只完成一部分任务时,优先用 complete-unit,不要把整条任务误标完成。
开始与结束专注
python3 scripts/focusflow.py start T001 25
python3 scripts/focusflow.py active
python3 scripts/focusflow.py interrupt <session_id> "临时沟通" manual
python3 scripts/focusflow.py end <session_id> 7 8
开始专注后,关联任务自动转为进行中。
补录与校正专注
python3 scripts/focusflow.py log-session T001 2026-08-03T20:00:00 90 "完成演示 Demo"
python3 scripts/focusflow.py adjust-session <session_id> 10
log-session:补录历史专注;free可表示不关联任务。adjust-session:将开始时间前移指定分钟,并把时长加回。
日报、周报与 HTML 报告
python3 scripts/focusflow.py daily-brief 2026-08-18
python3 scripts/focusflow.py daily-html 2026-08-18
python3 scripts/focusflow.py weekly-brief
python3 scripts/focusflow.py weekly-summary
python3 scripts/report_generator.py /path/to/focusflow_report.html
daily-brief:输出日报 JSON/文字摘要数据。daily-html:生成卡片式可视化日报 HTML,默认保存到~/.workbuddy/focusflow/reports/daily/YYYY-MM-DD.html。包含核心指标、效率分析、优化建议、专注趋势、中断、明日优先 Todo、今日 Done,以及可折叠查看的全局 Todo / 进行中 / Done。- 用户说“生成日报/推送日报/看日报/今天复盘”等意图时,默认同时执行
daily-brief+daily-html:先在对话框推送文字摘要,再用present_files推送 HTML 文件;不得只发文字,除非用户明确说只要文字。 - 每日自动化日报默认每天 22:00 推送上述双层日报。用户说“日报改为每天 X 点推送”时,查看已有「FocusFlow 每日专注日报」自动化并更新其 RRULE,禁止重复创建第二条日报自动化;随后确认新的推送时间。
- HTML 生成失败时,仍推送文字摘要,并明确说明失败原因。
- 文字日报固定结构:一句话判断 → 四项核心指标 → 今日 Done → 效率分析 → 优化建议 → 明日 Top3 → 全局 Todo / 进行中 / Done 数量 → HTML 日报文件路径(附在文字日报最后一行)。
- 文字日报最后给出 HTML 日报的本地路径参考,格式如:
📎 HTML 日报:/Users/.../outputs/focusflowdailyYYYY-MM-DD.html。注意:WorkBuddy 对话框不会解析 Markdown 链接或file://URL 的点击行为,文字路径仅供复制定位。实际打开 HTML 日报必须靠present_files推送,由 WorkBuddy 内置浏览器渲染预览。 - 周小结重点:本周完成事项、专注数据、关键亮点和下周动作。
交互工作流
收到新 Todo
- 创建任务并补充工作/生活、优先级、截止日期。
- 自动任务分诊;只向用户展示最关键的 3–5 个专注单元。
- 给出明确判断:今天先做哪一个,不只罗列任务。
- 用户说"现在开始"时,立即启动专注记录。
批量录入多个 Todo(强制规范)
当用户一次性报多个待办(如"帮我记几个 todo:1、… 2、… 3、…")时,必须遵守以下规则,否则会出现"只生成表格、不实际拆分专注单元"的 bug:
- 逐条调用 add-task——一次 10 个任务也要发 10 次 add-task 命令,禁止只输出一个汇总表格替代调用。每次 add-task 内部会自动调用 buildfocusunits 生成 2-4 个专注单元,单条调用即可完成拆解。
- 串行执行——逐条调用,前一条返回后再发下一条;绝不可并行 add-task(与"完成/改期/补录"等命令同属写库命令,并行会互相覆盖导致 JSON 损坏)。
- 逐条展示分诊结果——返回每条任务后,回复中列出该任务的「任务ID / 标题 / 优先级 / 分类 / 预计番茄钟数 / 已自动拆成 N 个专注单元(按编号列出每个单元名称)」,并给出推荐做的时间段。最后再给一个总览(按截止日期排序,今天/明天该先做哪几个)。
- 失败处理——若任一条 add-task 报错(如 title 含特殊字符),先修复该条重试,不可整批跳过。
用户反馈进度
- “完成了” → 标记整条任务完成。
- “其中一项完成” → 只完成对应专注单元,保留其他单元。
- “A 和 B 合并” → 保留一个主任务,另一个标记已合并,避免重复统计。
- “实际早开始 N 分钟” → 用
adjust-session校正。 - “之前做了 X 小时” → 用
log-session补录。
任务过多或大量过期
- 先运行
sweep,不要直接批量删除。 - 让用户按“完成 / 不做 / 改期”给出判断。
- 用批量命令收口,再运行
today输出新的今日焦点。 - 避免所有任务都标高优先级;高优任务控制在真正有硬截止的少数事项。
任务拆解原则
- 每个专注单元应在 15–60 分钟内完成。
- 必须有可验收边界,避免“继续推进一下”。
- 大任务优先拆成:目标/素材/结构/初稿/检查/提交。
- 小任务可作为“快速见效的小成果”,但不要用英文 quick win 堆砌表达。
- 临近截止且高优先级的任务优先;疲劳时避免硬磨低价值文字任务。
数据安全与同步
- 禁止并行调用会写 data.json 的命令(add-task / complete-task / batch-* / log-session / start / end / adjust-session / sweep 等所有会改库的命令):这些命令都是「读全文件→改→全文件覆盖写」模式,并发执行会互相覆盖并损坏 JSON(实测会出现「Extra data / Expecting value」错误)。务必串行调用——一条命令返回后再发下一条;即使用户一次报多个待办,也要逐条 add-task,不要为省时间并行。恢复方法:用
json.JSONDecoder().raw_decode(s)提取第一个完整 JSON 对象并重写文件,多余尾部通常是另一条命令的写入残留;恢复前先备份损坏文件。 - 个人任务数据只在
~/.workbuddy/focusflow/data.json,打包分享 skill 时禁止包含该文件、备份文件或任务导出。 - 手机端使用 WorkBuddy 云端工作空间时,应把通用 skill 部署到云端;个人任务数据需单独、经用户授权同步。
- 冲突策略:已完成状态不回退;Session(专注记录)和中断记录只追加;Focus Unit(专注单元)保留父任务和顺序。
同分类其他技能
查看全部 ›育儿大师.Skill——0-18 岁全场景家庭养育支持,服务对象是家长。只要用户的问题涉及孩子(0-18 岁)的养育、健康、行为、情绪、
103 313.7万 防骗大师.Skill防骗大师.Skill:你身边的生活类防骗专家。 当用户贴来可疑的短信、聊天记录、邮件、链接、App 或电话转述,想知道"这是不是骗局"时
40 207.4万 anti-fraud防骗大师.Skill:你身边的生活类防骗专家。 当用户贴来可疑的短信、聊天记录、邮件、链接、App 或电话转述,想知道"这是不是骗局"时
2 175.4万 育儿专家0-18岁全场景家庭养育支持系统,覆盖衣食住行、发育里程碑、行为情绪、症状就医、沟通话术、早教学习、危机识别与父母成长,服务家长、孕爸妈
1 57.5万 parenting-expert育儿大师.Skill——0-18 岁全场景家庭养育支持,服务对象是家长。只要用户的问题涉及孩子(0-18 岁)的养育、健康、行为、情绪、
0 56.2万 WorkBuddy积分助手WorkBuddy积分助手(WorkBuddy积分查询、获取、播报 Skill,跨平台支持 Windows / macOS / Linu
10 26.5万