never-miss（不错过）

把散落在口述、截图、邮件里的日程与截止事项，变成 macOS 系统日历里带提醒的事件；提醒由操作系统负责，写入后不再依赖本 Skill 是否在线。

1. 模式判定（先判断当前属于哪种模式）

| 模式 | 判定信号 | 下一步 | |---|---|---| | ①交互建提醒 | 用户消息含日程意图（提醒我/记一下/安排/会议/截止…），含口述或截图 | 走 §3 | | ②自动扫描 | 宿主注入哨兵提示 【never-miss:auto-run】 | 读 references/runbook-auto.md | | ③查询 | "建了哪些提醒/今天有什么/本周日程/运行状态" | 走 §6 | | ④配置维护 | "配置日程提醒/再配一个邮箱/删账户/停用账户" | 走 §7 |

2. 铁律（不可妥协）

相对时间换算前必须先执行 now 取锚点；换算结果必须写进回复明示（NFR-01）
缺字段如实标"未提供"，禁止编造时间与参与者（FR-13）
缺开始时间 / 时间歧义：交互模式追问，自动模式跳过（FR-21/22/24/25）
创建成功必须复述完整详情，时间用绝对日期时间（如"9月5日（周六）15:00"）
任何失败不静默；按错误码给修复指引或上报（FR-30）
密码只经 stdin 入 Keychain，任何输出打码；配置与日志不留明文（FR-03）

3. 交互建提醒流程

now 取时间锚点
提取字段并换算（规则见 references/extraction-rules.md，含 deadline 识别与全天判定）
缺开始时间 / 时间歧义 → 追问；低置信度 → 追问
冲突检查：check-conflict --start <ISO> --end <ISO>；有冲突则告知用户决定（改期/照建/放弃）
构建 Event JSON（见 §5）→ 经 stdin 传给 create
按输出复述详情；status:"ics_fallback" 时提示用户双击导入 .ics；duplicate 时说明已存在

4. 命令速查

数据目录：NEVER_MISS_DATA 环境变量 > 默认 ~/.workbuddy/never-miss。所有命令用 python3 scripts/never_miss.py <cmd>，输出结构化 JSON。

| 命令 | 用途 | |---|---| | now | 时间锚点（换算前置） | | init | 生成 config.yaml 与 state.json | | secret set/check/delete <邮箱> | Keychain 读写删（set 的密码经 stdin） | | doctor [--write-test] | 逐账户自检（配置/时区/Keychain/IMAP/日历） | | create [--journal] | 建日历事件（Event JSON 经 stdin；自动模式加 --journal） | | check-conflict --start --end | 查时间冲突 | | mail list/read | 交互式看/读邮件（FR-09） | | scan fetch/commit | 自动扫描：取信（游标不动）/ 推进游标 | | journal skip/error | 补记跳过/失败（自动模式） | | query events/status | 只读查询（最近 N 天 / 时间范围 / 运行状态） |

错误码：E_ARGS E_CONFIG E_KEYCHAIN E_IMAP E_CALENDAR E_AUTH E_UNSUPPORTED E_STATE E_INTERNAL。对照处置见 references/troubleshooting.md。

5. Event JSON 契约（create 的 stdin）

{
  "title": "项目评审",
  "start": "2026-09-12T10:00:00+08:00",
  "end": "2026-09-12T11:00:00+08:00",
  "all_day": false,
  "location": "会议室A",
  "attendees": ["张三"],
  "reminder_lead_minutes": 60,
  "source": {"account": "me@example.com", "mail_subject": "评审通知", "mail_uid": 48213}
}

title、start 必需；end 可省略（普通事件默认 +1h，全天事件默认单日）
全天事件：all_day:true 且 start 用 YYYY-MM-DD
source：邮件来源必填（account/mail_subject/mail_uid）；对话来源可省略

create 返回：status ∈ created|duplicate|ics_fallback，另有 uid、conflicts、ics_path、event（回显）。

6. 查询（只读）

最近 N 天建的提醒：query events --created-days N（默认 7）→ 倒序表格（主题/时间/来源账户/来源邮件主题）
某时间段日程：query events --from YYYY-MM-DD --to YYYY-MM-DD
运行状态：query status（上次运行、各账户游标、新建/跳过/失败、待汇报标记）
空结果明确回复"没有"

7. 配置维护

对话式收集账户必填项（host/username/label）；各家"专用密码"获取见 references/mail-setup.md
写 config.yaml（不含密码）+ secret set <邮箱>（stdin 传密码）
doctor --write-test 逐项汇报；提示宿主注册每天 schedule.time 定时任务
追加/停用/删除账户 = 改 YAML；删除时提示是否清理 Keychain

8. 引用（按需加载）

提取规则（字段/时间换算/置信度/deadline）：references/extraction-rules.md
自动模式完整流程：references/runbook-auto.md
邮箱专用密码指引：references/mail-setup.md
错误码处置：references/troubleshooting.md