excretion-tracker

# Excretion Tracker（排泄记录） This skill is **chat-only**: always log via the bundled CLI and store data locally. ## 0) Safety / scope - No medical diagnosis. - If the user reports **blood in stool/urine**, **severe pain**, **fever**, or symptoms lasting >24–48h, recommend professional medical advice. ## 1) What to collect (required vs optional) ### New: Attempt (no output) If the user reports **abdominal pain / urge** and **no pee/poop produced** (e.g., “蹲了20分钟都没有产出”), log an `attempt` event with: - start time - duration - pain - intent: poop | pee | unknown - notes Do not force color/Bristol when there was no output. ### Required for every log - `type`: pee | poop | attempt (no output) - `start_at`: timestamp (default: now) - `duration_sec`: integer (if unknown, ask) - `pain`: 0–3 (0 none, 1 mild, 2 moderate, 3 severe) ### Color requirement - For `pee` and `poop`: color is required - For `attempt` (no output): color is not required ### Poop-only - `bristol`: 1–7 (ask if poop) ### Optional - `notes`: short free text ## 2) Bristol stool scale (what it is) Bristol（布里斯托大便分类）把便便形态分为 1–7： - 1–2：偏干硬（便秘倾向） - 3–4：相对正常 - 5–7：偏稀（腹泻倾向） If user doesn’t know, ask 1 question: - “更像：1/2（很硬成颗粒） 3/4（成形） 5/6/7（软烂到水样）？” See details: `references/bristol.md`. ## 3) Color options (display to user in Chinese; English in Title Case) ### Pee color - Clear（透明） - Pale Yellow（浅黄） - Yellow（黄色） - Dark Yellow（深黄） - Amber（琥珀色） - Red（红） - Brown（褐） - Other（其他） ### Poop color - Normal Brown（正常棕） - Light Brown（浅棕） - Yellow（黄） - Green（绿） - Black（黑） - Red（红） - Pale（偏浅/灰白） - Other（其他） Internal storage can still use snake_case enums, but never show snake_case to the user. ## 4) Chat-only flow (includes optional card feedback) When the user says they went to the bathroom: 1) Determine `type` (pee/poop). If unclear, ask. 2) Ask only missing required fields **in the user's language** (Chinese). - If you need to show any English options, format them in **Title Case** (no underscores). 3) Ask for: - start time (if not specified) - duration (minutes/seconds) - color - pain (0–3) - for poop: bristol (1–7) 4) Log the event via CLI: `excretion log ...`. 5) **Optional visual card (SOP):** - Cards are **disabled by default**. - If the user enables cards, detect whether `nano-banana-pro` is installed. - If installed: follow `references/card_sop.md` to generate a consistent cute 3:4 card using **nano-banana-pro** and send it. - If not installed: **skip silently** (no extra questions). Enable/disable: - Enable: `excretion config set card_enabled 1` - Disable: `excretion config set card_enabled 0` Note: This skill intentionally ships **no image-generation scripts**. The agent executes the SOP by invoking `nano-banana-pro` only when cards are enabled. If user says “刚刚/刚才” → use now. If user provides duration like “2分钟” → convert to seconds. ## 5) Commands to run - Log pee: - `excretion log pee --start-at "..." --duration-sec 60 --color yellow --pain 0 --notes "..."` - Log poop: - `excretion log poop --start-at "..." --duration-sec 180 --color normal_brown --pain 1 --bristol 4 --notes "..."` - Show weekly summary: - `excretion week` - Set reminder threshold (hours): - `excretion config set poop_remind_hours 24` ## 6) Weekly summary (what to send) Include: - Poop frequency + avg interval - Bristol distribution (counts) - Poop pain average - Pee frequency (day vs night) - Red-flag events count (blood/pain>=3) - “Not medical advice” note ## 7) Files - CLI: `scripts/excretion.py` - Bristol reference: `references/bristol.md` - (Optional) Card generation SOP: `references/card_sop.md` (uses `nano-banana-pro` if installed; otherwise skip)