yz0812 Report - Git 周报/月报
基于 Git 提交记录生成周报/月报。
使用方法
/ac-report [参数]
触发解析
解析用户输入，提取以下参数：
| 参数 | 默认值 | 示例 |
|---|---|---|
| 类型 | 周报 | "周报" / "月报" |
| 用户 | 当前 git user.name | "@张三" |
| 日期 | 本周/本月 | "12月"、"2025-01"、"最近10天" |
解析示例：
"/ac-report 生成本周周报" → 类型=周报, 用户=当前, 日期=本周
"/ac-report 生成12月月报" → 类型=月报, 用户=当前, 日期=12月
"/ac-report 生成周报 @张三" → 类型=周报, 用户=张三, 日期=本周
"/ac-report 生成最近10天的周报" → 类型=周报, 用户=当前, 日期=最近10天
执行流程
1. 检测 MCP 可用性
优先使用 mcp__server-git__git_log，不可用则使用 Bash git log。
2. 计算日期范围
周报（无指定）→ 本周一 00:00 ~ 今天 23:59
月报（无指定）→ 本月1日 00:00 ~ 今天 23:59
"12月月报" → 12月1日 ~ 12月31日（或今天，若当月）
"最近N天" → N天前 00:00 ~ 今天 23:59
3. 获取用户名
指定 @用户名 则使用该用户，否则：
git config user.name
4. 查询提交记录
使用 MCP（优先）：
mcp__server-git__git_log
repo_path: 当前目录
start_timestamp: 起始日期
end_timestamp: 结束日期
然后按 author 过滤。
使用 Bash（降级）：
git log --author="用户名" --since="起始日期" --until="结束日期" --pretty=format:"%h - %s (%ai)" --no-merges
5. 美化提交记录
禁止原样输出 git log，必须进行以下处理：
- 合并相似提交：同一功能的多次提交合并为一条
- 过滤噪音：忽略 Merge commit、Delete 目录等无意义提交
- 规范描述：将简短的 "更新"、"修改" 补充为完整描述
- 分类整理：按功能模块或类型分组
输出格式：序号列表，不含日期
1. 完成用户认证模块开发，包括登录、注册、密码重置功能
2. 添加签到日志请求详情和状态筛选功能
3. 修复打包配置问题
6. 填充模板
读取 assets/templates/weekly.md 或 assets/templates/monthly.md，替换变量：
| 变量 | 说明 |
|---|---|
{{DATE_RANGE}} |
日期范围，如 "2025-01-06 ~ 2025-01-10" |
{{USER}} |
用户名 |
{{COMMITS}} |
美化后的工作内容 |
{{COMMIT_COUNT}} |
提交总数 |
{{REPOS}} |
涉及仓库名（从 repo_path 提取） |
{{STAT_LINES}} |
代码行数统计（仅模板包含时计算） |
7. 输出结果
将填充后的模板内容输出给用户。
模板自定义
模板位于 assets/templates/，用户可修改或新增模板。
可选变量 {{STAT_LINES}}：若模板包含此变量，额外执行：
git log --author="用户名" --since="起始" --until="结束" --shortstat --oneline | grep -E "^\s*\d+\s+file"
汇总 insertions/deletions。
多仓库支持
若用户指定多个路径，对每个路径分别查询，合并结果后生成报告。