团队周报生成Skill的核心目标是自动汇总团队工作成果、生成规范的周报、节省管理时间。在敏捷开发和DevOps流程中，每周都需要产出高质量的团队进展报告，但手动整理不仅耗时且容易遗漏重要信息。通过构建一个专门用于周报生成的Skill，可以将数据采集、内容编排、格式转换和分发的全过程自动化，让团队管理者将精力集中在分析和决策上，而不是文字整理工作。
该Skill的设计遵循"数据驱动、模板化输出"的原则，将输入数据（Git记录、项目管理工具API）与输出模板解耦，支持灵活定制周报的样式、内容和分发渠道。无论是小型创业团队还是大型企业组织，都可以通过配置适配自身的周报规范。
周报的质量取决于数据的完整性和准确性。团队周报生成Skill通过对接多种数据源，实现全方位的数据自动采集，确保周报内容真实反映团队一周的工作全貌。
通过Git API或本地仓库日志，自动统计本周内每个成员的提交次数、提交分布时间、涉及的分支信息。对于典型的分支模型（如Git Flow），还能区分feature、hotfix、release分支的提交比例，帮助管理者了解代码库的活跃度和开发节奏。
拉取GitHub/GitLab/Gitee等平台的Pull Request数据，统计本周内新创建的PR数量、已合并PR数量、待审查PR数量、平均审查周期以及每个审查者的参与度。这些指标直接反映了团队代码审查的效率和协作健康度。
对接Jira、飞书项目、Notion数据库或GitHub Issues，获取本周完成的任务、进行中的任务和新增的任务数量，以及每个任务的状态变更记录。支持按Epic、Sprint或自定义标签维度汇总，生成可视化的燃尽图或进度条。
统计每个成员本周新增、删除和修改的代码行数，帮助识别工作量分布。同时结合语言类型分析（如Python、TypeScript、Go等），了解各技术栈的变更活跃度。
在完成数据采集后，Skill会自动编排内容结构，生成逻辑清晰、重点突出的周报正文。内容编排遵循金字塔原理——先概括整体，再展开细节，确保各级读者都能快速获取关键信息。
从所有已完成事项中自动筛选出高优先级、高影响力的工作成果，按"重大突破 > 功能交付 > 问题修复 > 技术改进"的优先级排序，形成本周亮点清单。同时支持人工标注重点，将特定事项置顶展示。
自动生成团队成员的贡献摘要，包含每人本周完成的Key Result、主要代码变更、主导的PR和推动的任务进展。采用统一的格式模板，确保公平展示每个人的工作成果，避免信息偏差。
识别和总结团队本周遇到的阻点（Blockers）和潜在风险，包括技术难题、依赖延迟、资源冲突、跨团队协调障碍等。Skill可以从任务评论、PR讨论和Slack消息中提取关键词，辅助发现隐藏的风险点。
基于本周期未完成的任务、已规划的下周期Sprint Backlog和产品路线图，自动生成下周的工作计划草案，包括每个成员的建议任务分配、优先级排序和预估工时。管理者只需微调确认即可。
汇总团队需要外部支持的事项，包括跨团队依赖、资源申请、决策等待等，形成清晰的待办清单，便于在周会上快速对齐和推动解决。
核心要点：周报生成不是简单罗列数据，而是通过结构化的编排和数据洞察，帮助团队和管理者快速掌握全局、发现盲点、聚焦重点。好的周报应该是"一页纸读懂团队一周"，而非事无巨细的流水账。
不同场景和受众对周报的格式和载体有不同需求。团队周报生成Skill支持灵活的输出和分发配置，一次生成、多处送达。
支持一键切换输出格式：Markdown适合嵌入Git仓库和开发文档，HTML适合在线浏览和嵌入网页，PDF适合正式汇报和存档。格式转换引擎保留所有样式和排版，确保在不同平台上的一致性。
通过Slack Webhook或API，将周报摘要或完整内容自动推送到指定频道（如#team-weekly、#general）。支持富文本消息和Block Kit布局，在Slack中直接展示周报核心数据和图表，团队成员无需离开Slack即可了解团队动态。
支持SMTP配置，自动将周报通过邮件发送给指定的收件人列表（如团队全员、项目经理、部门负责人）。支持HTML邮件正文（图文并茂）和PDF附件两种方式，满足正式沟通场景的需求。
通过Notion API或Confluence REST API，将周报自动发布到团队知识库的指定页面中，形成按周编排的历史存档。所有历史周报集中管理，方便后续回溯、趋势分析和团队交接查阅。