← 返回 Skills 市场

git-release-notes

Name: git-release-notes
Author: charlie-morrison

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

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install git-release-notes

功能描述

Generate polished release notes and changelogs from git history. Analyzes commits between tags/refs, categorizes changes (features, fixes, breaking changes,...

使用说明 (SKILL.md)

Git Release Notes

Generate formatted release notes from git commit history. Analyzes commits between any two refs (tags, branches, SHAs) and produces categorized, human-readable release notes.

Quick Usage

Generate Notes Between Tags

scripts/gather_commits.sh v1.2.0 v1.3.0

Then format the JSON output into release notes using the formatting rules below.

Generate Notes Since Last Tag

scripts/gather_commits.sh $(git describe --tags --abbrev=0) HEAD

Generate Notes Between Branches

scripts/gather_commits.sh main release/2.0

Workflow

1. Gather Commits

Run scripts/gather_commits.sh \x3Cfrom_ref> \x3Cto_ref> to get structured commit data (JSON array).

If no refs provided, ask user for:

The starting point (tag, branch, or SHA)
The ending point (default: HEAD)

2. Categorize Commits

Group commits by type using conventional commit prefixes and content analysis:

Category	Prefixes / Signals	Emoji
Breaking Changes	`BREAKING CHANGE:`, `!:` in subject	💥
Features	`feat:`, `feature:`, `add:`	✨
Bug Fixes	`fix:`, `bugfix:`, `hotfix:`	🐛
Performance	`perf:`	⚡
Documentation	`docs:`, `doc:`	📚
Refactoring	`refactor:`	♻️
Testing	`test:`, `tests:`	🧪
CI/Build	`ci:`, `build:`, `chore:`	🔧
Dependencies	`deps:`, `dep:`, "bump", "upgrade" in subject	📦
Other	Anything else	📝

If commits don't follow conventional commits, analyze the commit message content to infer categories.

3. Format Release Notes

Default format (GitHub Release style):

# v1.3.0

> Released on 2026-03-26 | 47 commits | 5 contributors

## 💥 Breaking Changes
- Remove deprecated `legacy_auth` endpoint (#234)

## ✨ Features
- Add dark mode support (#220)
- Implement batch export for CSV/JSON (#215)

## 🐛 Bug Fixes
- Fix race condition in queue processor (#228)
- Correct timezone handling for UTC offset (#225)

## ⚡ Performance
- Optimize database queries for dashboard load (#222)

## 📦 Dependencies
- Bump express from 4.18 to 4.21

## 🔧 Other
- Update CI pipeline for Node 22

**Full Changelog:** v1.2.0...v1.3.0

4. Alternative Formats

Compact (for small releases):

v1.3.0 — Dark mode, batch export, 5 bug fixes. Breaking: removed legacy_auth.

Keep a Changelog (keepachangelog.com):

## [1.3.0] - 2026-03-26
### Added
- Dark mode support
### Changed
- Optimized dashboard queries
### Removed
- Deprecated legacy_auth endpoint
### Fixed
- Race condition in queue processor

Slack/Discord announcement:

🚀 **v1.3.0 is out!**

Highlights:
→ Dark mode support
→ Batch CSV/JSON export
→ 5 bug fixes

⚠️ Breaking: `legacy_auth` endpoint removed — migrate to `/v2/auth`

Customization

Users can specify:

Format — github (default), compact, keepachangelog, slack
Include/exclude categories — "skip docs and chore commits"
Group by — category (default), author, scope
PR links — auto-detect GitHub PR numbers (#NNN)
Contributors — list contributors at the bottom
Scope filter — only include commits touching certain paths

Scripts

scripts/gather_commits.sh \x3Cfrom> \x3Cto> — Outputs JSON array of commits with hash, author, date, subject, body

安全使用建议

This skill is mostly coherent for generating release notes, but review the included script before running. Specific checks: 1) It uses git and python3 even though the metadata lists no required binaries — ensure those are available and intended. 2) The script emits author email addresses and full commit bodies in JSON; if you plan to run it against repos containing private emails or sensitive commit messages, remove or mask the email/body fields. 3) Because it’s an instruction-only skill with an embedded script, run it in a safe environment (or a copy of the repo) first to confirm behavior. If you don’t trust the source, don’t run it against sensitive repositories. Finally, you may ask the author to update the metadata to declare required binaries (git, python3) and to add an option to omit emails/body for privacy.

功能分析

Type: OpenClaw Skill Name: git-release-notes Version: 1.0.0 The skill is a legitimate tool for generating release notes from Git history. The core logic in `scripts/gather_commits.sh` uses standard git commands and a Python helper to structure commit data into JSON, while `SKILL.md` provides clear instructions for the AI agent to categorize and format the output without any signs of malicious intent or data exfiltration.

能力评估

ℹ Purpose & Capability

The skill's stated purpose (generate release notes from git history) matches the included script and SKILL.md workflow. However, the files rely on git and python3 (git log and an inline Python JSON serializer) even though the skill metadata declares no required binaries; that omission is an inconsistency the author should have declared.

✓ Instruction Scope

SKILL.md instructions are narrowly scoped to reading git history between refs, categorizing commits, and formatting output. It does not instruct the agent to read unrelated system files, environment variables, or send data to external endpoints.

✓ Install Mechanism

This is an instruction-only skill with a small bundled script. There is no install spec and no remote downloads. The script runs local git and Python commands and writes only to stdout; no installation actions are performed by the skill itself.

ℹ Credentials

No environment variables or external credentials are requested (OK). But the script extracts and emits author emails and other commit metadata in full JSON — reasonable for release notes or contributor lists, but it may expose private email addresses or other sensitive commit details. The skill does not declare or warn about this privacy exposure.

✓ Persistence & Privilege

The skill does not request persistent presence (always:false) or elevated privileges and does not modify other skills or system config. Autonomous invocation is allowed by default (normal).

如何使用

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

版本历史

v1.0.0

Initial release

元数据

Slug git-release-notes

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题