📊 Git Progress Report (Git 项目进展报告)

一键将杂乱无章的 Git 提交记录，转化为结构化、有洞察力的高质量项目报告。

🌟 核心价值 (Value Proposition)

• 🤖 自动化梳理，解放生产力：告别人工翻阅 commit 记录，一键生成精美的 Markdown 格式周报、月报或发版日志。
• 🧠 智能归类，拒绝流水账：自动将代码变更提炼为 产品特性 (Features)、技术改进 (Improvements)、Bug 修复 (Fixes) 和 安全风险 (Security) 四大核心维度。
• 🔍 深度剖析，无惧“烂注释”：同事的提交信息全是 update 或 fix？开启 deep（深度）模式，直接穿透到代码 Diff 层，基于实际变更的文件和代码逻辑智能推断改动意图。
• 🛡️ 安全左移，风险早发现：内置敏感文件和特征扫描，自动识别配置更改、鉴权模块调整及潜在风险代码，将安全隐患暴露在常规报告中。

🎯 典型使用场景 (Use Cases)

1. 📝 打工人的“周报/月报神器”

每到周五或月底，不用再苦思冥想这周到底敲了什么代码。一条指令，自动拉取指定时间段的工作产出，直接复制粘贴到工作汇报中，既详实又专业。

2. 🚢 快速生成发版日志 (Release Notes)

在准备新版本发布时，轻松提取两个版本或时间节点之间的功能清单和修复列表，稍微润色即可作为对外的 Release Notes。

3. 👥 Tech Lead / 项目管理者的全局视角

不需要逐行 Code Review，通过深层模式快速掌握团队近期的开发节奏、代码库健康状况（新增功能与修复 Bug 的比例），以及是否有意料之外的“敏感配置”被修改。

4. 🔄 接手新项目或休假归来

当你刚接手一个历史项目，或者休假回来需要快速跟上进度时，生成一份近期的深度报告，快速提炼出核心业务逻辑的变更点。

🚀 如何使用 (How to Use)

本 Skill 提供了非常灵活的指令方式，直接在对话框中输入即可：

⚡ 基础用法（快速模式）

基于 Commit Message 分析，速度极快，适合提交规范的团队。默认分析最近一周：

/git-progress-report

🔬 深度模式（强烈推荐）

基于实际的文件 Diff 分析，适合提交信息不规范的场景，分析结果更精准：

/git-progress-report --mode=deep

📅 自定义时间范围

支持自然语言时间描述或具体的日期区间：

/git-progress-report --since="2 weeks"
/git-progress-report --since="2026-03-01" --until="2026-03-15"

📈 报告内容包含什么？

生成的报告使用优雅的 Markdown 格式呈现（基于 assets/report_template.md），包含以下模块：

• 📊 概览数据：总提交数、变更文件数、代码增删行数、参与贡献者。
• 🎯 产品特性 (Product Features)：面向用户的新增功能和业务逻辑变动。
• 🔧 技术改进 (Technical Improvements)：架构重构、性能优化、依赖升级、基建调整等。
• 🐛 Bug 修复 (Bug Fixes)：各类缺陷、异常处理和崩溃修复。
• 🔒 安全风险 (Security Risks)：高亮提示涉及鉴权、密钥、配置文件等高危目录的变动。

---

💡 让机器去读懂代码，把时间留给真正的创造。现在就开始用 git-progress-report 自动生成你的第一份工作报告吧！