用途
HabitFlow 是一款 AI 驱动的原子习惯追踪系统，帮助用户通过自然语言交互、带宽限的连续打卡追踪、智能提醒以及基于《原子习惯》的循证辅导技巧来建立长期习惯。当用户提到创建习惯、记录完成情况、查看进度、管理提醒或寻求习惯辅导时激活该技能。
主要能力
自然语言记录：支持“I meditated today”“walked Monday and Thursday”等表达。解析脚本为 npx tsx scripts/parse_natural_language.ts --text "I meditated today"。置信度处理规则：≥ 0.85 自动执行并确认；0.60–0.84 先请用户确认；< 0.60 请求澄清。
习惯管理：可查看、创建、更新、归档习惯。
- 查看：
npx tsx scripts/view_habits.ts --active --format markdown - 创建：
npx tsx scripts/manage_habit.ts create --name "Morning meditation" --category mindfulness --frequency daily --target-count 1 --target-unit session --reminder "07:00" - 更新：
npx tsx scripts/manage_habit.ts update --habit-id h_abc123 --name "Evening meditation" --reminder "20:00" - 归档：
npx tsx scripts/manage_habit.ts archive --habit-id h_abc123
记录完成：支持单日、批量、带次数与备注的记录。
- 单日：
npx tsx scripts/log_habit.ts --habit-id h_abc123 --date 2026-01-28 --status completed - 批量：
npx tsx scripts/log_habit.ts --habit-id h_abc123 --dates "2026-01-22,2026-01-24,2026-01-26" --status completed - 带次数与备注：
npx tsx scripts/log_habit.ts --habit-id h_abc123 --date 2026-01-28 --status completed --count 3 --notes "Felt great today"
状态选项包括 completed（达到或超过目标）、partial（有进展但未达标）、missed（未记录完成）、skipped（有意跳过，如休假、休息日）。
统计与进度：
- 单个习惯统计：
npx tsx scripts/get_stats.ts --habit-id h_abc123 --period 30 - 全部习惯汇总：
npx tsx scripts/get_stats.ts --all --period 7 - 连续打卡计算：
npx tsx scripts/calculate_streaks.ts --habit-id h_abc123 --format json
Canvas 可视化：
- 连续打卡图：
npx tsx assets/canvas-dashboard.ts streak --habit-id h_abc123 --theme light --output ./streak.png - 完成热力图：
npx tsx assets/canvas-dashboard.ts heatmap --habit-id h_abc123 --days 90 --output ./heatmap.png生成后通过 Read 工具在对话中展示图片。
主动辅导：HabitFlow 会在合适时机自动发送辅导消息，包括里程碑庆祝（达到 7、14、21、30+ 天连续打卡）、风险预警（高风险情境前 24 小时）、每周回顾（每周日 7pm）和模式洞察（检测到显著模式时）。主动辅导使用 clawdbot 的 cron 系统调度。初始设置运行 npx tsx scripts/init_skill.ts，会创建 3 个 cron 任务：每日辅导检查（8am）、每周回顾（周日 7pm）、模式洞察（周三 10am）。可通过 npx tsx scripts/check_cron_jobs.ts 检查状态，--auto-fix 自动修复缺失任务。同步命令：npx tsx scripts/sync_reminders.ts sync-coaching；移除：--remove。注意：cron 任务不会在技能安装时自动创建，需要运行 init_skill.ts 或 sync-coaching；技能更新后需再次运行 init_skill.ts；消息发送到最后活跃的聊天频道。
智能提醒：
- 同步全部：
npx tsx scripts/sync_reminders.ts --sync-all - 为单个习惯添加：
npx tsx scripts/sync_reminders.ts --habit-id h_abc123 --add - 移除：
npx tsx scripts/sync_reminders.ts --habit-id h_abc123 --remove提醒通过 WhatsApp 发送。
使用方式
角色与人格：该技能扮演习惯教练，沟通风格根据用户配置中的 activePersona 字段调整。加载流程为读取 ~/clawd/habit-flow-data/config.json 获取 activePersona，再加载 references/personas/{activePersona}.md 并采用其风格。可用人格：flex（专业、数据驱动，默认）、coach-blaze（活力运动教练）、luna（温和治疗师）、ava（好奇的效率极客）、max（轻松伙伴）、sofi（禅意极简）、the-monk（智慧哲学家）。切换人格时读取当前配置、更新 activePersona、加载新人格文件并确认。展示人格时可显示对应图片（如 personas/coach-blaze.png）。
首次设置：初始化数据目录 mkdir -p ~/clawd/habit-flow-data/logs；创建包含用户时区、flex 人格和默认用户 ID 的默认 config.json；欢迎用户并介绍能力；提供人格选择；引导创建第一个习惯。
教练技巧：应用《原子习惯》中的循证方法，包括从极小处开始（2 分钟规则）、与现有日常挂钩（习惯叠加）、减少阻力并增加即时奖励、识别中断点、与身份认同相连（“我是……的人”）。
错误处理：找不到习惯时列出活跃习惯并询问；解析置信度低时请求确认或澄清；无活跃习惯时提示创建；日期解析失败时提示支持“today”“yesterday”“Monday”或“2026-01-28”等格式。
适用场景
适合希望以低摩擦方式建立和追踪日常习惯（如冥想、喝水、锻炼、写日记）的个人用户，尤其适合偏好自然语言交互、需要智能提醒与数据化进度反馈，以及希望获得个性化教练式鼓励的用户。
限制
参考资料中未提供收费、价格或平台支持范围等具体信息。依赖 Node.js 18+ 与 npm。主动辅导需要手动运行初始化或同步命令创建 cron 任务，不会在安装时自动创建。提醒依赖 WhatsApp 渠道。
安装
通过 clawdhub 添加时由 install.sh 自动安装；手动安装执行 ./install.sh。安装脚本会检查 Node.js 与 npm，安装依赖（chrono-node、string-similarity、zod、commander、tsx、typescript），并运行初始设置（创建数据目录、配置 cron 任务）。