习惯追踪助手

技能简介

HabitFlow 是一款基于 AI 的原子习惯追踪工具，支持用自然语言记录日常行为，自动计算连续打卡天数，并通过可视化面板展示进度趋势。该工具整合了《原子习惯》中的循证教练技术，提供多种 AI 人格化辅导风格。

业务背景

帮助个人用户轻松建立并维持长期习惯，通过自然语言交互降低记录门槛，智能容错机制减少挫败感，可视化进度反馈增强持续动力。适用于健身、阅读、冥想等自我提升场景，让原子习惯的复利效应真正落地。

落地案例：一位职场人士希望培养每日冥想习惯，在HabitFlow中设置"每晚9点提醒"后，只需对手机说"今天冥想了15分钟"即可完成记录。某周因出差漏打卡一天，系统自动保留连续进度不中断；月末打开面板，可直观看到本月完成热力图和趋势曲线，AI教练根据《原子习惯》方法给出下阶段建议。

能做什么

• 自然语言录入：直接说”我今天冥想了”或”周一和周四散了步”即可记录
• 智能连续打卡：采用1天容错机制，避免因单次遗漏打断整体进度
• 可视化面板：生成连续打卡图表、完成热力图、周趋势分析及多习惯总览
• 定时提醒：通过 WhatsApp 在设定时间发送通知
• 主动式辅导：自动庆祝里程碑、发出风险预警、进行每周复盘
• 七种 AI 教练人格：Flex、Coach Blaze、Luna、Ava、Max、Sofi、The Monk
• 进度数据分析：统计完成率、趋势走向、表现最佳日期
• 多类别支持：健康、健身、效率、正念等场景

使用说明

安装步骤

1. 进入工作目录：cd ~/clawd/skills
2. 克隆仓库：git clone https://github.com/tralves/habit-flow-skill.git habit-flow
3. 安装依赖：cd habit-flow && npm install
4. 激活技能：对网关发送指令”refresh skills”或重启网关

创建首个习惯

npx tsx scripts/manage_habit.ts create \
  --name "晨间冥想" \
  --category mindfulness \
  --frequency daily \
  --target-count 1 \
  --target-unit session \
  --reminder "07:00"

记录完成情况

npx tsx scripts/log_habit.ts --habit-id h_abc123 --status completed

查看习惯列表

npx tsx scripts/view_habits.ts --active --format markdown

获取统计数据

npx tsx scripts/get_stats.ts --habit-id h_abc123 --period 30

生成可视化面板

# 连续打卡图
npx tsx assets/canvas-dashboard.ts streak --habit-id h_abc123

# 完成热力图
npx tsx assets/canvas-dashboard.ts heatmap --habit-id h_abc123 --days 90

# 周趋势
npx tsx assets/canvas-dashboard.ts trends --habit-id h_abc123 --weeks 8

# 多习惯总览
npx tsx assets/canvas-dashboard.ts dashboard

输入与输出

见下方输入与输出表格。

风险提示

• 数据存储采用本地 JSON/JSONL 格式，建议定期备份防止丢失
• WhatsApp 提醒功能需提前配置消息服务接口
• 自然语言解析依赖 chrono-node 库，复杂日期表达可能存在识别偏差
• 连续打卡容错机制为1天，频繁中断仍会影响长期数据统计

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tralves/habit-flow-skill/SKILL.md
来源类型：GitHub 开源项目