Pet Companion Journal
Overview
Use this skill to maintain a local-first companion archive for one or more pets. Record profiles, daily moments, feeding changes, photos, health history, and reminders in a way that stays organized per pet and is easy to search later.
This skill is best for:
- - creating or updating pet profiles
- recording daily logs, warm moments, and growth notes
- attaching photos and captions to a pet timeline
- tracking food, supplements, and feeding changes
- storing symptom, clinic, medication, vaccine, and deworming notes
- checking upcoming care reminders
- reviewing a pet’s recent history or exporting a summary
Workflow
1. Identify the pet first
Always determine which pet the record belongs to.
Rules:
- - if the household has only one pet, you may infer the pet after a quick confirmation when needed
- if the user has multiple pets and did not specify which one, ask before writing
- for reads, prefer showing likely matches and ask only if ambiguous
Use scripts/pet_manager.py list or view to inspect existing pets.
2. Create or update the pet profile
When the user is creating a profile, collect the minimum useful fields first:
- - name
- species
- birthday or approximate age
- breed if known
- gender if known
Optional fields:
- - nickname
- adoption date
- neutered status
- color markings
- personality tags
- notes
- avatar photo reference
Use scripts/pet_manager.py create and update.
3. Add records by type
Use
scripts/record_add.py to save records under the correct pet.
Supported record types:
- -
daily: ordinary daily notes - INLINECODE6 : warm scenes, funny moments, growth milestones
- INLINECODE7 : a photo plus caption and optional media path
- INLINECODE8 : food, supplements, quantity, feeding change notes
- INLINECODE9 : symptoms, clinic visits, medicines, vaccines, deworming, follow-up
- INLINECODE10 : notes related to reminders or care planning
If the user gives semi-structured text, store the narrative in the body and place structured fields such as symptom lists, medicine names, or scene labels inside extra.
4. Manage reminders
Use
scripts/reminder_manage.py to create or list per-pet reminders.
Use
scripts/reminder_check.py to find due or upcoming reminders.
Typical reminder types:
- - birthday
- vaccine
- deworming
- checkup
- grooming
- bath
- refill-food
- medication
- follow-up
5. Query and review
Use
scripts/record_query.py for structured retrieval.
Support filtering by:
- - pet
- record type
- time range
- keyword
Use scripts/export_report.py to produce a compact summary for a time range.
Output Rules
- - Keep responses warm, clear, and organized.
- For write actions, confirm what was saved and under which pet.
- For read actions, prefer concise summaries plus the most relevant entries.
- For health-related notes, record and organize them, but do not present veterinary diagnosis.
- If a photo path or detail is uncertain, label it as a note or estimate instead of pretending certainty.
Storage Rules
Default storage root: INLINECODE16
Structure:
- -
pets/: one JSON profile per pet - INLINECODE18 : markdown records with JSON frontmatter
- INLINECODE19 : one JSON reminder file per pet
- INLINECODE20 : pet photos or attachment files
- INLINECODE21 : exported summaries if needed
See:
- - INLINECODE22
- INLINECODE23
- INLINECODE24
- INLINECODE25
Privacy and Safety
This skill is local-first. Do not share pet photos, clinic notes, or identifying details unless the user explicitly asks. This skill may organize health records, but it must not act like a veterinary diagnosis or treatment tool. If the user describes urgent symptoms, advise prompt veterinary care.
宠物伴侣日志
概述
使用此技能为一只或多只宠物维护以本地优先的陪伴档案。以每只宠物为单位有序记录档案信息、日常瞬间、喂食变化、照片、健康史和提醒事项,便于日后检索。
本技能适用于:
- - 创建或更新宠物档案
- 记录日常日志、温馨时刻和成长笔记
- 在宠物时间线上添加照片和说明文字
- 追踪食物、营养品和喂食变化
- 存储症状、就诊、用药、疫苗和驱虫记录
- 查看即将到来的护理提醒
- 回顾宠物近期历史或导出摘要
工作流程
1. 首先确定宠物
始终明确记录所属的宠物。
规则:
- - 若家中仅有一只宠物,可在必要时快速确认后推断
- 若用户有多只宠物且未指定,需先询问再记录
- 读取时优先显示可能匹配项,仅在存在歧义时询问
使用 scripts/pet_manager.py list 或 view 查看现有宠物。
2. 创建或更新宠物档案
当用户创建档案时,先收集最小必要字段:
- - 名称
- 物种
- 生日或大致年龄
- 品种(如已知)
- 性别(如已知)
可选字段:
- - 昵称
- 领养日期
- 绝育状态
- 毛色特征
- 性格标签
- 备注
- 头像照片引用
使用 scripts/pet_manager.py create 和 update。
3. 按类型添加记录
使用 scripts/record_add.py 将记录保存到对应宠物名下。
支持的记录类型:
- - daily:日常笔记
- moment:温馨场景、趣味瞬间、成长里程碑
- photo:照片及说明文字,可选媒体路径
- feeding:食物、营养品、数量、喂食变化记录
- health:症状、就诊、用药、疫苗、驱虫、复诊
- reminder-note:与提醒或护理计划相关的笔记
若用户提供半结构化文本,将叙述内容存入正文,将症状列表、药物名称或场景标签等结构化字段存入 extra。
4. 管理提醒
使用 scripts/reminder_manage.py 创建或列出每只宠物的提醒。
使用 scripts/reminder_check.py 查找到期或即将到来的提醒。
常见提醒类型:
5. 查询与回顾
使用 scripts/record_query.py 进行结构化检索。
支持按以下条件筛选:
使用 scripts/export_report.py 生成指定时间范围内的简洁摘要。
输出规则
- - 保持回复温暖、清晰且有条理。
- 写入操作时,确认保存内容及所属宠物。
- 读取操作时,优先提供简洁摘要及最相关的条目。
- 涉及健康记录时,进行记录和整理,但不得提供兽医诊断。
- 若照片路径或细节不确定,标注为备注或估算,而非假装确定。
存储规则
默认存储根目录:~/.pet-companion/
结构:
- - pets/:每只宠物一个JSON档案
- records/YYYY/MM/:带JSON前置元数据的Markdown记录
- reminders/:每只宠物一个JSON提醒文件
- media/YYYY/MM/:宠物照片或附件文件
- reports/:按需导出的摘要
参见:
- - references/data-schema.md
- references/query-patterns.md
- references/template-examples.md
- references/safety-boundaries.md
隐私与安全
本技能以本地优先为原则。除非用户明确要求,否则不得分享宠物照片、就诊记录或可识别身份的信息。本技能可整理健康记录,但不得充当兽医诊断或治疗工具。若用户描述紧急症状,应建议立即就医。