打卡统计与报告

要解决什么问题

群打卡往往有各自的活动规则：达标线、核心指标（距离、时长、次数等）、排序方向和惩罚机制。管理员需要按「本日 / 本周 / 本月」或自定义区间出进度排名、周期结算、跨周期对比或催办提醒，且名单必须覆盖全员——包括未打卡成员，不能只看有记录的人。

本 skill 不负责写打卡记录，而是配合 check-in-manager-skill，从约定目录读取活动规则与 JSON 记录，完成统计与报告输出。

如何工作

数据来源（v4）：活动配置在 check-in-manager-skill/activities/{group_id}/{activity_id}.txt（自然语言规则）；打卡记录在 records/{group_id}/{activity_id}/YYYY-MM-DD.json。group_id 做目录级隔离，Activity ID 形如 {类型}_{创建者}_{时间戳}（纯英文/数字）。

典型流程分五步：

1. 解析请求 — 确定时间周期、报告类型（A 排名 / B 结算 / C 对比 / D 催办）与目标活动；未指定则扫描当前群活动列表。
2. 定位数据 — 解析群组 ID，读取 TXT 提取活动名、达标线、核心指标、排序与惩罚规则；用 load_records.py 加载日期范围内记录。
3. 统计计算 — 调用 calc_stats.py，支持 count、sum、avg、max/min、divide_sum、multiply_sum、last_minus_first 等七种模式；输出为纯数值 value，无记录成员为 value: 0, count: 0，并保留 records 供二次分析。
4. 格式化与成稿 — 由 AI 按规则 TXT 做单位转换（如配速 3.95 → 3'57"/km），再按 references/report-templates.md 生成对应类型报告；跨周期对比需 compare_periods.py，排名与达标可用 rank_and_qualify.py。
5. 回复用户 — 通过消息工具推送报告，结尾含鼓励语。

边界与注意点

• 数据真实性：只使用 records/{group_id}/{activity_id}/ 下实际文件，不臆造记录。
• 规则驱动：达标线、排序方向、核心指标必须 100% 来自活动 TXT，不得自行改规则。
• 群组隔离：仅统计当前群，不跨群读目录。
• 报告正文应使用格式化后的指标，而非原始浮点数；模板细节以 skill 内 report-templates.md 为准。