# Habit

> 习惯打卡 — 需要长期坚持并追踪'做了没有'的事（如运动、喝水、学习）。

- Skill: `shikidmsh-rgb/habit` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add shikidmsh-rgb/habit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shikidmsh-rgb/habit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shikidmsh-rgb (https://skillmd.com/u/shikidmsh-rgb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shikidmsh-rgb/habit

---


# Habit Skill

追踪需要长期坚持的习惯（如运动、喝水、学习）。用户通过聊天打卡，日记状态面板实时反映进度。

## Tools

### query_habit (routed)
读取习惯的今日进度或历史统计，例如当天打卡和月度跑步次数。

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| action | string (enum: list, stats) | yes | list = 今日进度；stats = 历史统计 |
| habit_id | integer | no | 习惯 ID（仅 stats 需要） |

### checkin_habit (routed)
为一个已有长期习惯增加或撤销完成记录，例如已经喝完一杯水或已经跑完步。

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| action | string (enum: checkin, undo_checkin) | yes | 操作类型 |
| habit_id | integer | yes | 习惯 ID |
| note | string | no | 备注 |
| count | integer | no | 打卡次数（默认 1） |

### edit_habit (routed)
创建或调整长期重复追踪的习惯，包括频率、重要性、暂停和恢复。

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| action | string (enum: add, remove, pause, resume, update) | yes | 操作类型 |
| habit_id | integer | no | 习惯 ID（remove/pause/resume/update） |
| name | string | no | 习惯名称（add 必填；update 可选） |
| frequency | string | no | daily:N、weekly:N 或 weekly_on:DAY,...:N（add 必填；update 可选） |
| category | string | no | 分类标签（如 health、pet、study） |
| importance | string | no | important 或 normal（默认 normal） |
| context | string | no | 时间安排备注 |
| until | string | no | 暂停截止日期（ISO 格式），默认 7 天 |

## Capability Context

- check-in 会改变完成计数，因此“打算做”或“晚点做”并不构成已完成事实。
- `pause` 会在多天范围内暂停追踪；它不会保存一次性的“稍后再看”念头。
- 每个写操作只改变参数中明确指定的习惯，结果会返回实际状态。