复盘卡片生成器 (reflection-card)

把一段杂乱的复盘笔记，变成一张可以打印、可以发朋友圈/发群、可以长期归档的「复盘卡片」。

一、这个 skill 解决什么问题

很多人每天/每周会随手记几句复盘（完成的事、学到的、卡住的、下一步），但这些文字散落在备忘录里，既不美观、也不成体系、更不方便回看。
本技能把这个过程固化成固定流水线：输入零散文本 → 结构化归纳 → 自动计算完成度进度环 → 套用主题色 → 产出一张精致卡片。
用户对结果有明确的格式要求（进度环 + 分区 + 可打印），这正是"普适化操作"无法直接给到的。

二、INPUT（用户需要提供什么）

调用本技能时，把用户的复盘内容整理为一个 JSON，字段如下：

> 最小可用输入：只要给 period + 任意几个字段即可生成卡片。

三、PROCESSING（中间做什么处理）

1. 结构化解析：把 done/learn/block/next 统一规整为条目列表（兼容"列表"和"多行文本"两种写法，自动去无序符号）。
2. 完成度计算：若用户给了 rating 直接用；否则按 len(done)/(len(done)+len(next)) 推算进度百分比。
3. 心情→主题色映射：
   - 含"开心/充实/兴奋/💪"或 rating≥70 → 暖色（橙粉，有能量感）
   - 含"累/焦虑/低落/😞"或 rating≤40 → 冷色（蓝绿，安抚感）
   - 其余 → 中性色（靛蓝）
4. 渲染卡片：调用同目录 generate.py，用内联 CSS 生成一张自包含 HTML 卡片，含 SVG 进度环、四个分区、时间戳与心情条。
5. 产出备份：同时写出一份 Markdown 备份，方便归档进笔记软件。

四、OUTPUT（用户拿到什么）

运行后在 --outdir 目录产出两个文件：

1. <period>-复盘卡.html —— 单页、自包含（无外部依赖）、可直接双击打开、可打印(Ctrl+P)、可整页截图分享。
2. <period>-复盘卡.md —— 纯文本备份，便于粘贴进 Notion/飞书/语雀等。

卡片视觉规范：720px 宽圆角白卡、进度环、四色分区、页脚署名；打印模式自动去阴影去背景。

五、怎么用（执行步骤）

1. 收集用户复盘内容，整理成 input.json（参照上面的 INPUT 表）。
2. 用托管 Python 运行同目录脚本：
   bash python generate.py --input input.json --outdir ./out
   > 若环境未装依赖：脚本仅用标准库（json/html/datetime/re/os/argparse），无需 pip install。
3. 把生成的 .html 与 .md 通过 present_files 交付给用户，并提示"可打印 / 可截图"。

六、示例 input.json

{
  "period": "2026-09-18 周四",
  "done": ["完成复盘卡片 skill 的初版", "跑通端到端演示", "写完作业说明文档"],
  "learn": ["skill 的三段式写法：INPUT/PROCESSING/OUTPUT", "Playwright 截图复盘卡很稳"],
  "block": ["chromium 首次下载较慢，需后台安装"],
  "next": ["把 skill 打成 zip 提交", "考虑是否发布到 skillhub"],
  "mood": "充实",
  "rating": 80,
  "author": "小明"
}