日报周报一键生成

问题在哪

站会、周报和项目同步往往要重复做两件事：从 git log 里翻 commit，再把任务、卡点和计划抄进固定模板。提交信息若是 conventional commits（feat/fix/docs 等），手工归类还能忍；条目一多就容易漏项，或者写成一串 hash 和英文 subject，非技术同事根本读不下去。

本技能面向的是已有文本输入的场景：你把提交记录、任务列表和计划贴进来（或从本地 log 文件读取），由脚本整理成可发的 Markdown，而不是替你连仓库、拉 Jira。

它怎么工作

入口是 scripts/main.py 的 generate 命令，通过参数拼装上下文：

• --git-log / --git-file：提交行用分号或换行分隔；会按类型聚合，把零碎 commit 归纳成「功能开发 / 问题修复 / 架构优化 / 工程化」等业务向表述
• --tasks、--blockers、--plans：逗号或分号分隔的列表，分别对应完成项、阻碍与下一阶段计划
• --type：选择 daily（站会日报）、weekly、project、monthly 四种模板结构
• --output：写出 .md；省略则打印到终端

日报模板侧重「昨日完成 / 今日计划 / 需要协助」；周报按类别汇总并拆出关键成果与下周计划；项目更新强调进度、里程碑与风险；月报会带提交分布类的总览段落。project 模板可配合 --project-name、--progress 等字段。

边界与注意

• 不会自动执行 git，也不接入飞书、Jira 等外部 API；没有 --git-log 时，计划区可能出现「（请补充今日计划）」一类占位，属预期行为
• 提交信息缺少 feat/fix 等前缀时，归类会退化为关键词猜测，准确率会下降
• 输出仅为 Markdown 文本，不含图表；需要 PDF/Word 需自行用编辑器转换
• Windows 终端若中文异常，优先用 -o 导出文件查看