智能周报生成助手

为什么需要结构化的周报生成

很多开发团队习惯从 git 历史直接提取变更，但如果把 commit hash 或原始的提交信息原样贴进周报，读者很难快速理解业务层面的进展。同时，周报往往需要面向不同受众：团队内部关注技术细节，直接上级更看重结果与影响，跨部门协作则需要避免 jargon 并强调配合。人工调整这些细节不仅耗时，还容易遗漏风险或阻塞项。

核心机制与工作流程

这个技能通过标准化的流水线将代码变更和口述要点转化为结构化的 Markdown 报告。

• 信息收集：自动解析时间范围（如「这周」「上周」或指定日期），读取 git log、未完成任务及用户补充的要点。
• 分类整理：严格按「已完成 / 进行中 / 风险与阻塞 / 下周计划」四个区块进行归类，这四个区块不可省略。
• 草稿生成与校验：遵循「结果优先」「一条一事」等写作原则，将 commit message 翻译为业务语言，随后通过 python scripts/validate.py 自动校验格式与字数。
• 条件分支：根据用户需求输出快速版（每区块 2-3 条）、详细版（带 PR/Issue 链接）或英文版。

适用边界与注意点

该技能适合需要频繁编写周报的一线研发人员或技术管理者。需要注意的是，它并非自动获取所有上下文的工具，仍需用户提供未完成任务和口述要点等输入。在校验时，如果脚本返回错误列表，需按提示修正后重新校验。此外，应避免在风险区块留空，如果没有风险也要明确写「无」。对于超过 500 字的草稿，建议合并同类项。