← Back to Skills Marketplace
wj-chitang

Git Log Summary

by WJ-chiTang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
119
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install git-log-summary
Description
生成Markdown格式的Git提交记录摘要报告。使用场景：当用户需要按照Markdown格式输出git仓库的详细统计信息时使用此技能。输出内容包括：项目信息、分支信息、提交统计、作者统计、最近提交记录、分支信息和提交类型统计等，全部以标准Markdown格式呈现。
README (SKILL.md)

Git Log Summary Skill (Markdown格式)

此技能用于生成Markdown格式的Git提交记录摘要报告，适合文档化、分享和在线阅读。

快速开始

基本用法

生成当前git仓库的Markdown格式提交记录摘要：

./scripts/generate_git_summary.sh

输出格式示例

# 项目名 Git提交记录摘要

## 报告信息
- **生成时间**: 2026-03-25 20:03:35
- **仓库路径**: `/path/to/repository`
- **仓库基本信息**:
  - **Git版本**: 2.39.5
  - **仓库创建时间**: 2026-03-05
  - **最后提交时间**: 2026-03-25

## 分支信息
### 当前分支
`master`

### 远程仓库
- origin https://example.com/repo.git (fetch)
- origin https://example.com/repo.git (push)

## 提交统计
### 总提交数
**总提交数**: 30

### 按作者统计
| 作者 | 提交次数 | 占比 |
|------|----------|------|
| user1 | 21 | 70.00% |
| user2 | 7 | 23.33% |

## 最近提交记录
显示最近 20 条提交记录：

| Commit Hash | 作者 | 提交时间 | 提交日志 |
|-------------|------|----------|----------|
| abc123 | user1 | 3 hours ago | feat: 新增功能 |
| def456 | user2 | 5 hours ago | fix: 修复问题 |

## 所有分支
### 本地分支
- master
- feature-branch

### 远程分支
- origin/HEAD
- origin/master

## 提交类型统计
基于最近1000条提交信息的类型分析：

| 类型 | 数量 | 占比 | 说明 |
|------|------|------|------|
| feat | 27 | 90.0% | 新功能 |
| fix | 2 | 6.7% | Bug修复 |

---
*报告生成完成*

脚本功能

主要脚本

scripts/generate_git_summary.sh - Markdown格式脚本，生成完整的git提交记录摘要

功能特性

  1. 项目信息提取：

    • 自动获取项目名称（从git remote或目录名）
    • 获取仓库路径和基本信息
    • 记录生成时间

  2. 分支信息：

    • 当前分支
    • 远程仓库信息
    • 所有分支列表

  3. 提交统计：

    • 总提交数
    • 按作者统计提交次数和占比（Markdown表格格式）
    • 提交类型统计（feat, fix, merge等）

  4. 详细提交记录：

    • 最近提交的详细记录（Markdown表格格式）
    • 格式化输出：Commit Hash | 作者 | 提交时间 | 提交日志

  5. 提交类型分析：

    • 自动分析提交信息中的类型前缀
    • 统计各类提交的数量和占比
    • 提供类型说明

使用示例

# 生成默认报告（自动保存为 项目名-git-log-年月日-时分秒.md）
./scripts/generate_git_summary.sh

# 指定输出文件
./scripts/generate_git_summary.sh -o custom-report.md

# 限制最近提交数量
./scripts/generate_git_summary.sh -n 20

# 包含所有分支的统计
./scripts/generate_git_summary.sh -a

# 组合使用
./scripts/generate_git_summary.sh -n 15 -a

自动文件名格式

当不指定-o参数时，脚本会自动生成文件名：

项目名-git-log-年月日-时分秒.md

示例：

long-shop-git-log-20260325-203045.md

文件名组成：

  • 项目名: 从git remote或目录名自动提取
  • git-log: 固定标识
  • 年月日: 报告生成日期（如20260325）
  • 时分秒: 报告生成时间（如203045）

远程仓库分析

远程分析脚本

scripts/generate_git_summary_remote.sh - 专门用于分析远程Git仓库

功能特性

  1. 自动克隆: 自动克隆远程仓库到临时目录
  2. 保留报告: 生成报告后保留报告文件
  3. 可选保留: 可选择保留或删除克隆的仓库
  4. 完整分析: 包含所有本地分析功能

远程仓库使用示例

# 分析远程仓库（自动生成报告文件）
./scripts/generate_git_summary_remote.sh -u https://gitee.com/forever_1236/long-shop.git

# 指定输出文件
./scripts/generate_git_summary_remote.sh -u https://gitee.com/user/repo.git -o my-report.md

# 保留克隆的仓库目录
./scripts/generate_git_summary_remote.sh -u https://github.com/user/repo.git -k

# 组合使用
./scripts/generate_git_summary_remote.sh -u https://gitee.com/user/repo.git -n 30 -a -o report.md

脚本参数

本地分析脚本 (generate_git_summary.sh)

  • -o, --output \x3Cfile>: 指定输出文件（默认自动生成：项目名-git-log-年月日-时分秒.md）
  • -n, --num-commits \x3Cnumber>: 指定显示的最近提交数量（默认20）
  • -a, --all-branches: 包含所有分支的统计（默认只统计当前分支）
  • -h, --help: 显示帮助信息

远程分析脚本 (generate_git_summary_remote.sh)

  • -u, --url \x3Curl>: 远程Git仓库URL（必需）
  • -o, --output \x3Cfile>: 指定输出文件（默认自动生成）
  • -n, --num-commits \x3Cnumber>: 指定显示的最近提交数量（默认20）
  • -a, --all-branches: 包含所有分支的统计（默认只统计当前分支）
  • -k, --keep-clone: 保留克隆的仓库目录（默认不保留）
  • -h, --help: 显示帮助信息

提交类型识别

脚本会自动识别以下提交类型：

  • feat: 新功能
  • fix: Bug修复
  • merge: 合并分支
  • docs: 文档更新
  • style: 代码格式调整
  • refactor: 代码重构
  • test: 测试相关
  • chore: 构建过程或辅助工具变动
  • perf: 性能优化
  • ci: CI/CD相关
  • build: 构建系统
  • revert: 回退提交

注意事项

  1. 确保在git仓库中: 脚本必须在git仓库目录下运行
  2. git版本: 需要git 1.8.0或更高版本
  3. 权限: 需要读取git配置和提交历史的权限
  4. 大型仓库: 对于大型仓库，统计所有提交可能需要较长时间

故障排除

常见问题

  1. "错误：当前目录不是git仓库":

    • 确保当前目录是git仓库
    • 运行 git init 初始化新仓库

  2. 统计不准确:

    • 运行 git fetch --all 更新远程分支信息
    • 使用 -a 参数包含所有分支统计

  3. 提交类型识别错误:

    • 检查提交信息是否符合约定格式（如 "feat: 添加新功能"）
    • 调整脚本中的类型匹配规则

性能优化

对于大型仓库：

  • 使用 -n 参数限制最近提交数量
  • 避免使用 -a 参数除非必要
  • 考虑使用 git log --since 限制时间范围
Usage Guidance
This skill appears to perform the advertised task, but take these precautions before running it: - Ensure you have git and common Unix utilities (git, bc, sed, coreutils) available—the package metadata does not declare these but the scripts require them. - Review the scripts locally before running. Pay attention to the remote script's use of eval to invoke the local analysis script with user-supplied arguments—avoid passing untrusted values for -o (output file) or -u (repo URL) to prevent shell injection. - When analyzing remote repositories, only clone repositories you trust or run the script inside an isolated environment (container, VM, or sandbox) because cloning untrusted repos can expose your environment to malicious content or unexpected large data. - If you will run this in automated contexts, consider replacing the eval invocation with a safe exec (avoid eval, pass arguments as an array) and sanitize user inputs. If you want to proceed safely, run the scripts manually in a disposable container first and inspect generated files and logs.
Capability Analysis
Type: OpenClaw Skill Name: git-log-summary Version: 1.0.0 The skill bundle contains a shell injection vulnerability in `scripts/generate_git_summary_remote.sh`. The script uses `eval` to execute a command string constructed with the `-o` (output file) argument without sufficient sanitization, which allows for arbitrary command execution if a malicious filename is provided. While the overall purpose of generating Git summaries appears legitimate and aligned with the documentation in `SKILL.md`, this implementation flaw poses a significant security risk in an environment where an AI agent might be prompted to use untrusted input.
Capability Assessment
⚠ Purpose & Capability
The skill's name/description (generate Markdown git commit summaries) matches the provided scripts' behavior. However the registry metadata declares no required binaries while the scripts clearly require git and other standard Unix tools (bc, sed, awk-like utilities). This mismatch between declared requirements and actual needs is an incoherence the user should be aware of.
⚠ Instruction Scope
SKILL.md instructs running the included scripts (local and remote). The scripts stick to git-related operations (reading repo history, cloning remote repos, writing a report file). They do not call external web endpoints other than performing git clone on a user-supplied URL. However the remote script executes a local script via eval with user-influenced parameters (OUTPUT_FILE/REPO_URL) which introduces potential shell-injection risk if untrusted inputs are supplied. The remote script also clones arbitrary URLs supplied by the user—this is expected for its purpose but increases attack surface when run against untrusted repos.
✓ Install Mechanism
No install spec; this is an instruction-only skill with included shell scripts. Nothing is downloaded or installed by the skill itself (lowest install risk).
✓ Credentials
No environment variables or credentials are requested. The scripts read git metadata and repository content only, which is appropriate for the described functionality.
✓ Persistence & Privilege
always is false and the skill does not request persistent/global privileges. It does create (and optionally remove) a temporary clone directory when analyzing remote repos, which is within the expected scope.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install git-log-summary
  3. After installation, invoke the skill by name or use /git-log-summary
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- 首发版本，提供 Markdown 格式的 Git 提交记录摘要报告生成脚本。 - 支持获取项目信息、分支信息、提交统计、作者统计、最近提交、分支列表、提交类型等详尽数据。 - 内置本地和远程仓库分析脚本，可自动生成文件名或自定义输出目标。 - 按作者和类型以 Markdown 表格呈现统计，便于文档化与分享。 - 提供丰富的脚本命令行参数，支持自定义统计范围和输出格式。
Metadata
Slug git-log-summary
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Git Log Summary?

生成Markdown格式的Git提交记录摘要报告。使用场景：当用户需要按照Markdown格式输出git仓库的详细统计信息时使用此技能。输出内容包括：项目信息、分支信息、提交统计、作者统计、最近提交记录、分支信息和提交类型统计等，全部以标准Markdown格式呈现。 It is an AI Agent Skill for Claude Code / OpenClaw, with 119 downloads so far.

How do I install Git Log Summary?

Run "/install git-log-summary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Git Log Summary free?

Yes, Git Log Summary is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Git Log Summary support?

Git Log Summary is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Git Log Summary?

It is built and maintained by WJ-chiTang (@wj-chitang); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments