360 Secure SkillHub
360 安全技能中心

Habit Tracker

通过 Python 脚本在本地 JSON 文件记录和统计习惯：添加、移除（软删除）习惯，打卡与撤销，查看当日完成情况、当前/最长连续天数及 7/30 天完成率，并生成 Markdown 周报，可保存到 Obsidian 目录。

newageinvestments25-byte
newageinvestments25-byte
热度 41.95
最近更新 2026-05-11 17:36:45
分类：生活依赖：代码执行 / 读写文件应用场景：健康 / 任务管理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add nai-habit-tracker
Metadata
name
habit-tracker
description
Track daily habits, streaks, and completions locally. Triggers on: habit, streak, track habit, log exercise, log habit, weekly review, habit status, did I exercise today, habit check, morning routine.

Habit Tracker Skill

Local habit tracking via JSON files. No external services or API keys. Data lives in ~/.openclaw/workspace/habits/ (override with HABIT_DATA_DIR env var).

Scripts live in scripts/ relative to this file. Resolve all script paths relative to this skill's scripts/ directory.

Commands

List habits

python scripts/setup_habits.py --list

Add a habit

python scripts/setup_habits.py --add "Habit Name" --frequency daily|weekday|weekly --emoji 🏋️
  • --frequency defaults to daily if omitted
  • --emoji is optional

Remove (archive) a habit

python scripts/setup_habits.py --remove "Habit Name"

History is preserved. Habit is soft-deleted.

Log a habit completion

python scripts/log_habit.py "Habit Name"
python scripts/log_habit.py "Habit Name" --date 2024-01-15
python scripts/log_habit.py "Habit Name" --undo
  • Accepts exact name, partial name, or ID
  • Prevents duplicate logging (safe to re-run)
  • --undo removes today's log entry

Check status

python scripts/status.py
python scripts/status.py --json
python scripts/status.py --date 2024-01-15

Outputs current streak, longest streak, today's completion, and 7/30-day rates.

Weekly review

python scripts/weekly_review.py
python scripts/weekly_review.py --week 2024-01-15
python scripts/weekly_review.py --output ~/Desktop/review.md
python scripts/weekly_review.py --obsidian

Generates a formatted markdown report. --obsidian saves to vault/habits/weekly-reviews/YYYY-MM-DD.md.

Interpreting User Requests

User says Action
"Did I exercise today?" status.py --json → find habit by name
"Log my run / I exercised" log_habit.py "Exercise"
"What's my reading streak?" status.py --json → extract streak for reading
"Log yesterday's meditation" log_habit.py "Meditation" --date YYYY-MM-DD
"Weekly review" weekly_review.py
"Add habit: cold shower" setup_habits.py --add "Cold Shower"
"Show all habits" setup_habits.py --list
"Remove journaling" setup_habits.py --remove "Journaling"

Frequency Semantics

  • daily — expected every calendar day
  • weekday — Mon–Fri only; weekend skips don't break streaks
  • weekly — once per 7-day window; streak = consecutive weeks with ≥1 completion

Output Handling

  • status.py (no --json): print directly to user
  • status.py --json: parse and reformat as a clean bullet list for Discord
  • weekly_review.py: offer to save to Obsidian (--obsidian) or print inline
  • Always confirm after log_habit.py with what was logged and current streak

Data Location

~/.openclaw/workspace/habits/
├── habits.json   # habit definitions
└── log.json      # daily completion records

Both files are auto-created. See references/data-format.md for schema details.