周报生成器（zhoubao-assistant）
给打工人的周报/月报/季度总结生成器：把散点工作记录丢进来，自动整理成结构化周报，替代「对着空白文档发呆半小时」。
核心差异化（对标 PPT快速搭建/汇报总结类）
- 竞品：靠 LLM 让用户"写一段周报"，给的是一整段文本，没结构、没数据、容易跑题。
- 我们：确定性脚本
report_gen.py把散点记录自动分类（已完成 / 进行中 / 问题风险 / 下周计划）→ 统计概览（事项数/完成/风险/下周）→ 生成 HTML 周报骨架 → Agent 结合细节补全正文。 - 结果：结构正确、不跑题、可复制到文档/邮件，每份都有"概览数字"打底。
快速开始
# 输入散点记录（每行一条，或用分号/句号分隔）
python3 scripts/report_gen.py --text "本周完成了官网改版上线；数据库迁移遇到阻塞风险；下周计划做性能优化；客户沟通已完成" --no "W37"
python3 scripts/report_gen.py --text "..." --html 周报.html # 导出HTML
python3 scripts/report_gen.py --json --text "..." # 机器可读
何时使用本技能
- 「帮我写周报 / 周总结 / 周报生成」
- 「这周我做了……（散点记录），帮我整理成周报」
- 「月报 / 季度总结 / 工作汇报 / 小结」
工作流（铁律）
- 先分类后补写：先跑
report_gen.py得到分类与概览。禁止跳过脚本直接让模型编周报。 - 细节由 Agent 补全：脚本给出骨架（哪些算完成、哪些是风险、哪些进下周），Agent 据此把每条扩成通顺的一句话/一段，保留用户的事实与数据。
- 可验证：概览数字来自脚本统计，不是编的；报告末尾标注"数据以用户录入为准"。
输出规范
- 终端：分类统计（事项总数 / 已完成 / 进行中 / 风险 / 下周）
- 报告：概览表 + 分节（本周进展/问题与风险/下周计划/需协调）+ HTML
- 诚实护栏：不虚构未录入的工作/数据；只补全表达，不改事实。
文件结构
zhoubao-assistant/
├── SKILL.md
├── NOTICE.md
├── references/
│ ├── 01-record-formats.md 散点记录格式与写法
│ ├── 02-section-guide.md 周报各节怎么写
│ └── 03-writing-tips.md 让周报更像人的技巧(可配合去AI味)
└── scripts/
└── report_gen.py 周报骨架引擎
环境要求
Python 3.8+，仅标准库。零联网、零第三方依赖。
输入输出示例
输入：「这周完成了官网改版上线、数据库迁移遇到阻塞、下周做性能优化、客户沟通已完成，帮我写个周报。」
处理：
1. report_gen.py --text "..." → 4条：已完成2（官网改版/客户沟通）、风险1（数据库阻塞）、下周1（性能优化）
2. Agent 补全：把"数据库迁移遇到阻塞"写成"数据库迁移因XX风险受阻，已评估处理方案，下周重点跟进"
输出：一份含概览+分类的周报，可直接发领导。
常见问题
- Q1：只给一句话能写吗？ 能，但越详细结构越准。建议每件事一条，用分号/换行分开。
- Q2：会不会编我没做过的事？ 不会。只按你给的记录分类，概览数字来自你录入的条数，不编造任何工作。
- Q3：要联网吗？ 不需要，纯本地。
- Q4：能配图/图表吗？ 本技能出文字+HTML骨架；如需图表可配合 report-diagram-kit / pptx 技能。
免责声明
- 本技能为办公写作辅助，周报内容与数据以用户提供为准，用户对外使用自负其责。
- 分类基于关键词启发式规则，个别条目可能归类偏差，Agent 应结合语义修正。
