← 返回 Skills 市场

Git Changelog Generator

Name: Git Changelog Generator
Author: charlie-morrison

作者 charlie-morrison · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install git-changelog-generator

功能描述

Generate structured changelogs from git history using conventional commits, with support for multiple formats, AI-enhanced descriptions, and customizable ran...

使用说明 (SKILL.md)

Git Changelog Generator

Generate structured changelogs from git history. Supports conventional commits, semantic versioning, and multiple output formats. Use when preparing releases, writing release notes, or documenting project history.

Usage

# Generate changelog for latest unreleased changes
python3 scripts/generate_changelog.py

# Generate changelog between two tags
python3 scripts/generate_changelog.py --from v1.2.0 --to v1.3.0

# Generate for last N commits
python3 scripts/generate_changelog.py --last 20

# Generate since a date
python3 scripts/generate_changelog.py --since 2026-04-01

Output Formats

# Markdown (default)
python3 scripts/generate_changelog.py --format markdown

# Keep a Changelog format (keepachangelog.com)
python3 scripts/generate_changelog.py --format keepachangelog

# GitHub Release format
python3 scripts/generate_changelog.py --format github-release

# JSON (for programmatic use)
python3 scripts/generate_changelog.py --format json

How It Works

Collect — reads git log between specified ranges
Parse — extracts conventional commit types (feat, fix, refactor, docs, test, chore, perf, ci)
Categorize — groups changes by type with human-readable headers
Enrich — adds PR links, issue references, author attribution, breaking change warnings
Format — outputs in the requested format

Conventional Commit Support

Parses standard prefixes:

feat: → Features
fix: → Bug Fixes
refactor: → Code Refactoring
docs: → Documentation
test: → Tests
perf: → Performance
ci: → CI/CD
chore: → Maintenance
BREAKING CHANGE: → Breaking Changes (highlighted)

Non-conventional commits are categorized as "Other Changes" with AI-assisted categorization.

Parameters

Parameter	Description	Default
`--from`	Start tag/commit	Last tag
`--to`	End tag/commit	HEAD
`--last`	Last N commits	All since last tag
`--since`	Start date (YYYY-MM-DD)	None
`--format`	Output format	`markdown`
`--output`	Write to file	stdout
`--repo`	Repository path	Current directory
`--include-authors`	Show commit authors	false
`--include-hashes`	Show commit hashes	false
`--group-by`	Group by `type` or `scope`	`type`

AI Enhancement

When used as an agent skill, the AI can:

Rewrite terse commit messages into human-readable descriptions
Identify the most impactful changes and highlight them
Generate a summary paragraph for release announcements
Detect breaking changes even without conventional commit markers
Cross-reference with issue trackers for richer context

安全使用建议

This skill is coherent and low-risk: it runs local git commands to build changelogs and requires no credentials. Before running, review the script if you want to be sure it will only read the intended repository path (default: current directory). If you expect the AI to enrich changelogs with issue data or external context, be aware that the skill does not include network code or credentials—any such lookups would come from the agent itself or other skills, so only allow those if you trust the agent's configured integrations.

功能分析

Type: OpenClaw Skill Name: git-changelog-generator Version: 1.0.0 The skill bundle is a legitimate utility for generating changelogs from Git history. The Python script (scripts/generate_changelog.py) safely uses subprocess.run with argument lists to interact with the git CLI, avoiding shell injection vulnerabilities, and the SKILL.md documentation contains no malicious instructions or prompt injection attempts.

能力评估

✓ Purpose & Capability

Name/description, SKILL.md usage examples, and the included Python script all align: the tool runs git log on a repository, parses conventional commits, groups and formats them. There are no unrelated environment variables, binaries, or install steps requested.

ℹ Instruction Scope

SKILL.md instructs running the bundled script and describes AI 'enhancements' (rewriting messages, cross-referencing issue trackers). The script itself performs only local git operations and formatting. The AI-enhancement language is high-level and gives the agent discretion to enrich output, but the skill does not include code or declared credentials to perform networked lookups; this is a mild vagueness rather than a mismatch.

✓ Install Mechanism

No install specification is provided (instruction-only + included script). Nothing is downloaded or written to disk by an installer; risk from install mechanisms is minimal.

✓ Credentials

The skill declares no required environment variables or credentials and the script does not read environment secrets. It only invokes git against a configurable repository path (default: current directory). No disproportionate credential access is requested.

✓ Persistence & Privilege

always is false and the skill does not modify agent/global configuration or other skills. It runs on demand and writes output only to stdout or a user-specified file.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install git-changelog-generator
安装完成后，直接呼叫该 Skill 的名称或使用 /git-changelog-generator 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of Git Changelog Generator. - Generate structured changelogs from git history with support for conventional commits and semantic versioning. - Flexible output formats: Markdown, Keep a Changelog, GitHub Release, and JSON. - Supports various input options: by tag, date, or commit count. - Groups and enriches changes, highlighting features, fixes, breaking changes, and more. - Includes AI-powered enhancements for improved categorization and readable summaries.

元数据

Slug git-changelog-generator

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题