her-cycle

要解决的问题

周期提醒类产品普遍把两件事混在一起：算日子和说话。结果就是，提醒文案里夹带建议、安慰和营销话术，用户信不过；Agent 每次还要临时推理生理背景，输出口径不一致。

@user_9e10d3ea/her-cycle 的解法是一句原则：脚本是传感器，LLM 是嘴。

核心设计：脚本算事实，Agent 管表达

脚本只输出四样东西：当前阶段、周期天数、数据来源、生理背景。它是纯事实层：

• source：confirmed（用户主动告知）或 predicted（脚本推算）
• period_length_override：当次周期天数覆盖，null 则取 config 默认
• inactive_cycles：连续 predicted 未确认的周期数
• wake_log：已触发的一次性事件，防止同一窗口重复唤醒

建议、安慰、提醒话术一概不出现在脚本输出里，表达方式完全交给 Agent 的身份层决定。

工作方式

冷启动需要用户提供种子数据，无种子数据脚本不运行、不预测、不唤醒：

• 必填：上次月经第一天、平均周期天数、提醒方式（push 或 blend）
• 可选：经期持续天数（默认 5）、近几个月起始日期、兜底时间

唤醒条件按生理阶段裁剪得很细：经期中每天唤醒，排卵窗口和 PMS 窗口每周期各一次，预计经期当天和推迟超 5 天各一次；卵泡期和黄体前期不打扰。

两种输出模式：push 模式下 cron 直接 stdout 输出；blend 模式写 data/pending_flag.json，等用户下次对话带出，兜底时间仍未送达则以自然聊天语气主动发起，发完必须调用 --mark-delivered，否则会重复推送。

适用边界与注意点

• inactive_cycles ≥ 3 时停止唤醒，需用户主动告知后 --add 重置
• 周期超 45 天只警告不拒绝，不规律周期本身是合法的
• 数据文件本地存储，提醒只在私聊触发，不上传云端
• Agent 需负责表达层，本技能不提供任何话术模板