用途
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:晨间简报可包含当日习惯目标