weekly-reportlisted

# 开发周报生成技能 根据 git commit 区间自动生成结构化的开发周报。 ## 触发条件 当用户请求生成周报、工作总结、或回顾近期代码提交时使用此技能。 ## 工作流程 ### 第一步：确定 commit 区间 根据用户输入判断分析范围： 1. **用户提供了明确的 commit 区间**（如 `abc123..def456`）—— 直接使用该区间 2. **用户提供了时间范围**（如"上周"、"本周"）—— 根据时间计算对应的 commit 范围 3. **用户未指定**—— 默认获取**上周工作日**（上周一 00:00 到 上周五 23:59）的提交 计算上周工作日的方法： ```bash # 获取上周一的日期（ISO格式 YYYY-MM-DD） last_monday=$(date -d "last monday" +%Y-%m-%d) # 如果今天是周一，"last monday"是昨天；否则是上一个周一 # 获取上周五的日期 last_friday=$(date -d "$last_monday +4 days" +%Y-%m-%d) # 用 git log 获取时间范围内的提交 git log --after="${last_monday}T00:00:00" --before="${last_friday}T23:59:59" --oneline --no-merges ``` 如果用户说的是"本周"，则用本周一到今天的范围。 ### 第二步：获取 commit 详情 执行以下命令获取完整信息： ```bash # 获取 commit 列表（排除 merge commit） git log --oneline --no-merges <commit-range 或 时间范围> # 获取每个 commit 的文件变更统计 git log --no-merges <range> --format="%H %s" | while read hash msg; do echo "=== $msg ===" git show $hash --stat --format="" done ``` 如果用户提供了 commit 区间（`A..B` 格式），使用该格式；如果使用时间范围，用 `--after` / `--before` 参数。 ### 第三步：过滤与归纳 **过滤规则** —— 忽略以下类型的提交： - Merge / merge branch 开头的 - 纯 chore / docs / style / test / build / ci 类型的（注意：如果 `docs:` 提交对应的是实际的代码/配置变更而非文档撰写，不应过滤） - typo / README / 纯注释修改 - 自动生成内容 **归纳规则** —— 这是生成高质量周报的核心： - 多个相似/相关的提交 → 合并为一个事项 - 多次修复同一问题 → 汇总描述 - 零碎提交 → 提炼为完整工作成果 - 关联的 feat + refactor + fix → 归纳为一个完整的成果条目 **表达要求**： - 每条表示"一项已完成的工作"，禁止逐条复述 commit - 使用"动词 + 结果"表达（实现了 / 优化了 / 修复了 / 重构了） - 优先体现功能或业务价值，而不是细节改动 - 避免空泛描述（如：修改代码、调整逻辑） - 如果能识别模块（前端 / 后端 / API / 性能 / 部署等），自然体现即可