职场周报一键生成
核心差异：市面上的「周报」工具大多在做「把流水润色成有说服力的汇报」（告诉你该怎么写得好、怎么向上管理）。本工具不抢这个——润色交给模型，本工具做的是结构化：把零散条目自动归类、自动统计数字、输出规范骨架，让「数据」由脚本算、不由嘴说。
何时使用
- 手上有一堆零散的本周记录（聊天、便签、待办），要拼成能交差的结构化周报
- 想一键出带数据摘要的周报（完成几项、风险几条、下周计划几项）
- 要 HTML 版直接发邮件 / 转 PDF
快速开始
准备一个输入文件 week.md，按四个区块填零散条目：
## 本周完成
- 完成A设备维保方案
- 输出B项目月度报告
## 进行中
- 推进D项目二期
## 风险与阻塞
- F供应商交期延迟
## 下周计划
- 启动G项目
- 提交I汇报
然后：
# 输出 Markdown（默认，贴进 IM / 文档）
python3 scripts/week_report.py --input week.md --title "设备组" --period "2026-11 第1周" --author "张三"
# 输出单文件 HTML（发邮件 / 转 PDF）
python3 scripts/week_report.py --input week.md --title "设备组" --html 周报.html
也支持 JSON 输入（{"done":[...], "doing":[...], "risk":[...], "next":[...]}）。
四个区块
| 区块 | 含义 | 别名（标题可写这些） |
|---|---|---|
done 本周完成 |
已交付/已完结的事项 | 本周完成 / 已完成 / 完成事项 / 本周产出 |
doing 进行中 |
正在推进的事项 | 进行中 / 推进中 |
risk 风险与阻塞 |
卡点、风险、需协调 | 风险与阻塞 / 风险 / 阻塞 / 问题与风险 / 需协调 |
next 下周计划 |
下周要做的事 | 下周计划 / 下周 / 计划 |
脚本按二级标题（##）切分区块，标题含上述任意别名即可识别；区块内每行 - 开头是一条目（无符号的行也容错当作条目）。
自动统计
输出顶部自动生成数据摘要：本周完成 N 项，进行中 N 项，提出风险 N 条，下周计划 N 项。数字由脚本数条目得来，不是手填的，避免「虚报」。
与其他工具的分工
| 工具 | 做什么 |
|---|---|
| 本工具 | 结构化 + 数据统计 + 输出骨架（Markdown/HTML） |
| 模型 / 去AI味工具 | 每条条目的措辞润色、话术 |
| 公文写作类 | 正式公文（函、通知、报告），不在本工具范围 |
配合：本工具产出结构化骨架 → 模型润色每条例措辞 → 去AI味工具降痕迹 → 上交。
不要使用本工具的场景
- 正式公文（函/通知/决定）→ 用公文 skill
- 只要「把流水变成有感染力的话」，不关心结构 → 直接用模型润色即可
- 复杂项目进度管理（甘特图、依赖、工时）→ 用 PM 工具
文件结构
SKILL.md 本文件
scripts/week_report.py 解析/统计/输出（无第三方依赖）
scripts/selftest.py 自检（11 用例）
references/format.md 周报结构与输出规范
assets/example/week.md 示例输入
