version: "1.0.1" name: habit description: "习惯打卡 — 需要长期坚持并追踪'做了没有'的事（如运动、喝水、学习）。" type: tool multi_turn: true diary_status_order: 10 writes: diary: [diary] db: [habit_checkins]
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 会在多天范围内暂停追踪；它不会保存一次性的“稍后再看”念头。- 每个写操作只改变参数中明确指定的习惯，结果会返回实际状态。