SuperAPI AI 工具集

habit-tracker

办公与效率

查看项目

更新于 10-16 06:56

技能介绍

用途

Habit Tracker 面向独立创业者,用于追踪每日重复性行为(如写作、锻炼、外联、深度工作)。它把习惯记录交给 AI 智能体,通过一个持久化的结构化状态文件来记录完成情况、维护连续打卡、计算完成率,并在行为即将中断前给出提醒。

主要能力

  • 在结构化状态文件中记录每日习惯完成情况
  • 追踪连续打卡(streak),计算 7 天 / 30 天完成率
  • 在心跳检查(heartbeat)中提示逾期未记录的习惯
  • 生成带趋势分析的每周习惯报告
  • 与 goal-tracker(习惯→成果)、solopreneur-assistant(周回顾)、financial-tracker(与收入相关的习惯)集成

使用方式

快速设置(约 5 分钟)

第一步:添加到 AGENTS.md。将以下常驻指令粘贴到 AGENTS.md:

## Habit Tracking
- State file: `habit-state.json` (habit definitions + daily log)
- Log completions when I report them (e.g., "did my writing today", "workout done")
- During heartbeat: check for habits not yet logged today; surface any that are overdue by >2 hours past their usual time
- On Sundays: generate a weekly habit report automatically
- Never nag more than once per session per habit
- Use the habit-tracker skill for all habit-related commands

第二步:创建状态文件。对智能体说:“Set up my habit tracker with the following habits: [list them]”,智能体会创建 habit-state.json,其中包含 habits 数组、log、streaks 和 last_weekly_report 字段。每个习惯包含 id、name、description、target_days、usual_time、category、linked_goal 等字段。

常用操作

  • 记录完成:“Writing done — finished the draft introduction.”
  • 记录跳过(带原因):“Skipping outreach today — traveling.”
  • 查看今日状态:“Habit status for today.”
  • 查看连续打卡:“What are my current streaks?”
  • 生成周报:“Give me my weekly habit report.”(或周日由心跳自动触发)
  • 新增习惯:“Add a new habit: 'Read 20 pages' every day, target time 9pm, category learning.”
  • 暂停/恢复习惯:“Pause the outreach habit for this week — I'm on vacation.” / “Resume outreach habit starting Monday.”
  • 编辑习惯:“Change writing habit to target Mon/Wed/Fri only.”

心跳集成

在 HEARTBEAT.md 中加入习惯检查指令:检查 habit-state.json 中今日尚未记录的习惯;若某目标习惯超过 usual_time 两小时仍未记录,则提示一次;周日生成并发送周报;同一会话中同一习惯不重复提醒。

定时任务替代方案

可使用 cron 做每日定时检查,例如:

openclaw cron add \
  --name "habit-evening-check" \
  --cron "0 20 * * *" \
  --model "anthropic/claude-haiku" \
  --session isolated \
  --message "Check habit-state.json. List any target habits not logged today. Keep it brief — just the unlogged ones and today's streak status." \
  --announce \
  --to "YOUR_TELEGRAM_CHAT_ID" \
  --tz "America/Chicago"

连续打卡规则

  • 目标日完成:连续 +1
  • 目标日未完成:连续重置为 0
  • 非目标日未完成:无影响
  • 习惯暂停:连续冻结(不中断)
  • 带备注的跳过:重置连续(诚实原则)

适用场景

适合需要追踪写作、锻炼、外联等重复行为的独立创业者;希望把习惯与目标、收入数据关联分析的用户;以及使用心跳或定时任务做每日提醒的工作流。

限制与说明

  • 所有习惯数据保存在本地 habit-state.json,智能体不会将习惯数据发送到外部服务,也不会在未经明确指示的情况下公开发布完成记录或与其他会话/智能体共享。
  • 若习惯日志过大,可让智能体将 90 天前的记录归档到 habit-archive-YYYY.json。
  • 若连续打卡感觉过于严苛,可改用 7 天滚动平均值作为主要指标。
  • 若智能体未检测到逾期习惯,需确认已设置 usual_time 且心跳指令包含习惯检查。
  • 若暂停的习惯仍被提示,需确认 habit-state.json 中的 paused_until 日期在未来。
  • 若关联目标找不到,需确认目标 ID 与 goal-tracker 状态文件中的完全一致。
  • 许可:CC BY-NC 4.0,个人使用免费,不得转售或在付费产品中再分发。

集成关系

  • goal-tracker:习惯关联目标,周报标记目标进度是否匹配
  • solopreneur-assistant:周回顾包含习惯完成率
  • financial-tracker:将收入相关习惯(外联、内容)与收入数据关联
  • decision-log:记录习惯系统设计决策
  • content-calendar:写作习惯驱动内容管线,完成日志作为工作证明
  • daily-briefing:晨间简报可包含当日习惯目标