ac-report

name	ac-report
description	基于 Git 提交记录生成周报或月报。
disable-model-invocation	true

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，必须进行以下处理：

1. 合并相似提交：同一功能的多次提交合并为一条
2. 过滤噪音：忽略 Merge commit、Delete 目录等无意义提交
3. 规范描述：将简短的 "更新"、"修改" 补充为完整描述
4. 分类整理：按功能模块或类型分组

输出格式：序号列表，不含日期

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。

多仓库支持

若用户指定多个路径，对每个路径分别查询，合并结果后生成报告。