Agent Skill

FocusFlow专注力神器-即刻进入心流!

AI帮你把散乱的待办事项拆成下一步可执行的专注单元(15-60分钟),用番茄钟记录专注与中断,自动生成专注力日报。支持工作/生活分类标签、优先级、效率复盘、今日专注趋势、优化建议等。适合多线程任务场景下的注意力管理与复盘。

生活服务·燃烧的良鸽·来自 skill_hub·skillhub.cn ↗
skillhub install @user_5206bb12/focusflow
11 Stars·2.6万 综合热度·4,137 字文档·源站更新 2026-10-28

README 文档

4,137 字

FocusFlow 专注流

把散乱待办转成“可执行下一步”,再用专注记录和日报复盘注意力流向。

数据与运行

  • 数据:~/.workbuddy/focusflow/data.json
  • 主脚本:scripts/focusflow.py
  • 报告脚本:scripts/report_generator.py
  • 用户级安装目录下的 skill 可在不同对话中使用。通常直接说“加个待办”“看任务列表”即可自动触发;需要强制指定时使用 @skill:focusflow。

核心能力

  1. 任务分诊台 Task Triage(任务分诊):把模糊 Todo 拆成 15–60 分钟的 Focus Unit(专注单元),每个单元包含完成边界、预计耗时、优先级和顺序。
  2. 任务管理:支持工作/生活标签,红黄绿优先级,截止日期,部分完成,批量完成和批量改期。
  3. 今日焦点与过期清理:从大量任务中选出今天最该做的 3 件事;扫描过期任务,提示完成、改期或归档。
  4. Session(专注记录)管理:开始/结束专注,记录中断、能量、专注评分;支持事后补录和开始时间校正。
  5. 复盘报告:生成 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

  1. 创建任务并补充工作/生活、优先级、截止日期。
  2. 自动任务分诊;只向用户展示最关键的 3–5 个专注单元。
  3. 给出明确判断:今天先做哪一个,不只罗列任务。
  4. 用户说"现在开始"时,立即启动专注记录。

批量录入多个 Todo(强制规范)

当用户一次性报多个待办(如"帮我记几个 todo:1、… 2、… 3、…")时,必须遵守以下规则,否则会出现"只生成表格、不实际拆分专注单元"的 bug:

  1. 逐条调用 add-task——一次 10 个任务也要发 10 次 add-task 命令,禁止只输出一个汇总表格替代调用。每次 add-task 内部会自动调用 buildfocusunits 生成 2-4 个专注单元,单条调用即可完成拆解。
  2. 串行执行——逐条调用,前一条返回后再发下一条;绝不可并行 add-task(与"完成/改期/补录"等命令同属写库命令,并行会互相覆盖导致 JSON 损坏)。
  3. 逐条展示分诊结果——返回每条任务后,回复中列出该任务的「任务ID / 标题 / 优先级 / 分类 / 预计番茄钟数 / 已自动拆成 N 个专注单元(按编号列出每个单元名称)」,并给出推荐做的时间段。最后再给一个总览(按截止日期排序,今天/明天该先做哪几个)。
  4. 失败处理——若任一条 add-task 报错(如 title 含特殊字符),先修复该条重试,不可整批跳过。

用户反馈进度

  1. “完成了” → 标记整条任务完成。
  2. “其中一项完成” → 只完成对应专注单元,保留其他单元。
  3. “A 和 B 合并” → 保留一个主任务,另一个标记已合并,避免重复统计。
  4. “实际早开始 N 分钟” → 用 adjust-session 校正。
  5. “之前做了 X 小时” → 用 log-session 补录。

任务过多或大量过期

  1. 先运行 sweep,不要直接批量删除。
  2. 让用户按“完成 / 不做 / 改期”给出判断。
  3. 用批量命令收口,再运行 today 输出新的今日焦点。
  4. 避免所有任务都标高优先级;高优任务控制在真正有硬截止的少数事项。

任务拆解原则

  • 每个专注单元应在 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(专注单元)保留父任务和顺序。

同分类其他技能

查看全部 ›