MCPInstall

git-weekly-report-cn

by yangsonhungCode Quality & Workflow

当用户需要把 Git 提交记录整理成结构化日报、周报或工作汇总时使用。

Installs
44
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/yangsonhung/awesome-agent-skills --skill git-weekly-report-cn
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads git-weekly-report-cn automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Git 周/日报生成

Overview

提取 Git 提交日志并生成结构化日报或周报。输出会把近期工作整理为完成事项、进行中事项、重要事项、计划和风险阻塞，并支持按时间范围、作者和仓库维度汇总，便于复用到站会、日报、周报或项目汇总中。

何时使用

当用户有以下需求时使用本技能：

  • 从 Git 提交记录生成周报或日报
  • 总结昨天或今天的 Git 活动
  • 汇总一个或多个仓库的近期 Git 活动
  • 回顾某个时间段内完成的工作
  • 将提交历史整理为分类报告
  • 从提交记录准备每日站会汇总

不要使用

以下场景不应使用本技能：

  • 对特定变更的代码审查（请使用 code-reviewer）
  • 查看单条提交的详细信息
  • 提取日志以外的 Git 操作（分支、合并等）
  • 与 Git 无关的报告生成

使用说明

  1. 确定日期范围和报告类型：
    • 日报：用户说"昨天"、"今天"、"日报"时 — 默认 --since 为昨天，--until 为今天
    • 周报：用户说"这周"、"本周"、"周报"时 — 默认 --since 为本周一，--until 为今天
    • 其他情况：默认最近 7 天。接受用户自定义。
  2. 确定作者过滤。如用户指定则使用，默认：全部作者。
  3. 确定仓库路径。默认：当前工作目录。如用户提及多个项目，收集所有路径。
  4. 运行脚本：
python3 scripts/git_weekly_report.py --since <YYYY-MM-DD> --until <YYYY-MM-DD> [--author <名称>] [--repo <路径1> <路径2> ...]
  1. 读取 JSON 输出。脚本按仓库分组提供结构化提交数据。
  2. 使用 weekly-report-format.md 作为分类指南，按类型归类提交。
  3. 使用 weekly-report-template.md 作为输出结构生成最终周报。
  4. "下周计划"和"风险阻塞"板块：需向用户确认是否有内容补充，这些信息无法从 Git 日志推导。日报默认不含这些板块，除非用户要求。
  5. 呈现最终 Markdown 周报。如用户需要，保存到文件。

脚本使用

# 默认：最近 7 天，当前目录
python3 scripts/git_weekly_report.py

# 指定日期范围
python3 scripts/git_weekly_report.py --since 2026-04-21 --until 2026-04-28

# 指定作者
python3 scripts/git_weekly_report.py --since 2026-04-21 --author "Yang"

# 多个仓库
python3 scripts/git_weekly_report.py --since 2026-04-21 --repo /path/to/project-a /path/to/project-b

# 保存输出到文件
python3 scripts/git_weekly_report.py --since 2026-04-21 --output /tmp/weekly.json

# 包含 merge 提交
python3 scripts/git_weekly_report.py --since 2026-04-21 --merges

JSON 输出结构

脚本输出 JSON，结构如下：

  • date_range: { since, until } — 查询的日期范围
  • author_filter: 字符串或 null — 应用的作者过滤
  • repositories: { path, name, commit_count, commits } 数组
  • total_commits: 所有仓库的提交总数

每条提交包含：hash、short_hash、author、date、subject、body、refs。

周报生成

当单个仓库的提交数超过 50 条时，按类别汇总而非逐条列出。始终保留 short_hash 以便追溯。

"进行中的工作"板块，留意以下信号：WIP、TODO、临时方案、未合并的功能分支。

"重要事项"板块，识别：breaking change、安全修复、重大功能上线、涉及关键路径的提交。

FAQ

What does the git-weekly-report-cn skill do?

当用户需要把 Git 提交记录整理成结构化日报、周报或工作汇总时使用。

How do I install git-weekly-report-cn?

Run npx skills add https://github.com/yangsonhung/awesome-agent-skills --skill git-weekly-report-cn in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/git-weekly-report-cn/ (personal) or .claude/skills/git-weekly-report-cn/ (project).

Which AI agents can use git-weekly-report-cn?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is git-weekly-report-cn safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains git-weekly-report-cn?

It is published by yangsonhung in yangsonhung/awesome-agent-skills. It has 44 recorded installs.

More from yangsonhung/awesome-agent-skills

View all →

novel-writer-cn

yangsonhung/awesome-agent-skills

当用户需要创作、续写、修改小说，或设计角色和世界观时使用。

Docs & Writing2.3K installs

novel-writer

yangsonhung/awesome-agent-skills

Use when writing, continuing, revising, or planning novels, characters, and fictional worlds.

Docs & Writing605 installs

topic-bookmarks-reorganizer-cn

yangsonhung/awesome-agent-skills

当用户需要按主题整理浏览器书签导出、URL 去重并生成可导入 HTML 时使用。

Frontend & Design70 installs

mac-software-storage-cleanup

yangsonhung/awesome-agent-skills

Use when auditing macOS app storage, cleaning priority caches, or recommending reclaimable disk space.

AI & Agents68 installs

conversation-json-to-md

yangsonhung/awesome-agent-skills

Use when converting chat export JSON into per-conversation Markdown files with preserved user-assistant Q/A and normalized headings.

AI & Agents64 installs

topic-bookmarks-reorganizer

yangsonhung/awesome-agent-skills

Use when reorganizing a browser bookmarks export by topic, deduplicating URLs, and producing an importable HTML file.

Frontend & Design63 installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Code Quality & Workflow1.4M installs

improve-codebase-architecture

mattpocock/skills

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

Code Quality & Workflow1.2M installs

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

Code Quality & Workflow1.1M installs

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

Code Quality & Workflow890.6K installs

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

Code Quality & Workflow863.8K installs

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Code Quality & Workflow848.4K installs