Agent Skills › t4t5/rencal › generate-release-notes

generate-release-notes

GitHub

根据 Git 标签差异自动生成项目发布说明。通过对比前后版本提交记录，提取用户可见的变更，按新功能、改进和修复分类，并引用 PR 或提交哈希，输出简洁专业的 Markdown 格式笔记。

.agents/skills/generate-release-notes/SKILL.md t4t5/rencal

Trigger Scenarios

用户要求总结两个版本或标签之间的代码变更用户请求生成特定范围的发布说明或更新日志

Install

npx skills add t4t5/rencal --skill generate-release-notes -g -y

More Options

Non-standard path

npx skills add https://github.com/t4t5/rencal/tree/main/.agents/skills/generate-release-notes -g -y

Use without installing

npx skills use t4t5/rencal@generate-release-notes

指定 Agent (Claude Code)

npx skills add t4t5/rencal --skill generate-release-notes -a claude-code -g -y

安装 repo 全部 skill

npx skills add t4t5/rencal --all -g -y

预览 repo 内 skill

npx skills add t4t5/rencal --list

SKILL.md

Frontmatter

{
    "name": "generate-release-notes",
    "description": "Draft short project release notes from git tag diffs. Use when asked to summarize changes between releases\/tags, especially when release notes should reference pull request numbers."
}

Release Notes

Use this skill to draft concise release notes for renCal from git history.

Workflow

Identify the current and previous release tags.
- If the user names a tag, use that as the current tag.
- Otherwise use git describe --tags --abbrev=0 for the current tag.
- Find the previous tag with git tag --sort=-creatordate or semver ordering when relevant.

Inspect the changes between tags:

git log --oneline --decorate <previous-tag>..<current-tag>
git diff --stat <previous-tag>..<current-tag>

Inspect commit subjects/bodies for PR references:
```
git log --format='%h%x09%s%x09%b' <previous-tag>..<current-tag>
```
- Preserve PR references like (#30) from merge/squash commit subjects.
- If a change comes from a non-PR commit, reference the short commit hash only when useful.
- Prefer grouping related implementation details under the same PR number instead of listing every touched file.
If the diffstat is broad or unclear, inspect focused diffs for changed areas:
```
git diff <previous-tag>..<current-tag> -- <path>
```

Output style

Return short bullet-form notes grouped under these headings, omitting any empty section:
- ### ✨ New features
- ### 🛠️ Improvements
- ### 🐛 Bug fixes
Mention the compared range before the grouped notes when helpful, e.g. v0.1.0 since v0.0.6.
Each bullet should describe user-visible impact first, then cite the PR/commit at the end.
Use HTML <kbd> tags for keyboard shortcuts, e.g. <kbd>Ctrl</kbd><kbd>K</kbd> or <kbd>.</kbd>.
Avoid internal implementation details unless they explain a visible improvement.
Keep wording release-note friendly: concise, polished, and understandable to users.

Example

### ✨ New features

- Added a <kbd>Ctrl</kbd><kbd>K</kbd> command palette for quickly switching themes, switching calendar groups, and performing other actions. (#47)
- Added “Go to date…” so you can jump directly to a specific date from the command palette or with <kbd>.</kbd>. (#50)

### 🛠️ Improvements

- Reminders now support weeks and months, not just shorter intervals. (#52)
- All-day event editing: disabled time fields look cleaner, and unchecking all-day restores the previously selected time. (#53)

### 🐛 Bug fixes

- Fixed a startup crash affecting some Nvidia driver setups. (#46)
- Fixed Linux single-instance handling so repeated launches focus the existing app instead of leaking extra WebKit processes. (#51)
- Fixed stale “today” state so the calendar updates correctly after the day changes. (098e366)