Agent Skills › gitkraken/vscode-gitlens › audit-commits

audit-commits

GitHub

审计提交日志，识别面向用户的变更，检查关联Issue和CHANGELOG条目。自动分类影响级别，生成摘要并提示用户确认，随后创建Issue或更新CHANGELOG，确保发布规范。

.claude/skills/audit-commits/SKILL.md gitkraken/vscode-gitlens

Trigger Scenarios

需要审计Git提交记录检查CHANGELOG完整性准备发布版本

Install

npx skills add gitkraken/vscode-gitlens --skill audit-commits -g -y

More Options

Non-standard path

npx skills add https://github.com/gitkraken/vscode-gitlens/tree/main/.claude/skills/audit-commits -g -y

Use without installing

npx skills use gitkraken/vscode-gitlens@audit-commits

指定 Agent (Claude Code)

npx skills add gitkraken/vscode-gitlens --skill audit-commits -a claude-code -g -y

安装 repo 全部 skill

npx skills add gitkraken/vscode-gitlens --all -g -y

预览 repo 内 skill

npx skills add gitkraken/vscode-gitlens --list

SKILL.md

Frontmatter

{
    "name": "audit-commits",
    "description": "Audit commits for issues and CHANGELOG entries"
}

/audit-commits - Audit Commits

Compare HEAD against a tag, identify user-facing commits, ensure they have linked issues and CHANGELOG entries.

Usage

/audit-commits [tag]

No tag: suggest the most recent (git tag --sort=-creatordate | head -10).

Workflow

Fetch commits: git log --format="%h %s" <tag>..HEAD
Analyze each (oldest first):
- Get diff: git show <sha> --stat and git show <sha>
- Classify: bugfix / feature / refactor / docs / tests / chore
- Assess impact: High / Medium / Low / None
- Check for linked issue (#<num> in message)
Group related commits (e.g., feature + immediate follow-up fix)
Check each user-facing commit against [Unreleased] in CHANGELOG.md
Present summary, confirm before creating issues or editing CHANGELOG

CHANGELOG Management

Uses Keep a Changelog format under [Unreleased].

Section Mapping

Change Type	Section
Feature	Added
Enhancement	Changed
Performance	Changed
Bugfix	Fixed
Deprecation	Deprecated
Removal	Removed

Entry Format

- [Verb] [description] ([#issue](url))

Guidelines:

Start with: "Adds", "Improves", "Changes", "Fixes", "Removes"
Use underscores for UI elements: _Commit Graph_, _Home_ view
Include issue reference if available
Be user-centric (what user sees, not code changes)

Example:

- Fixes an issue where the _Home_ view would not update when switching repositories ([#4717](https://github.com/gitkraken/vscode-gitlens/issues/4717))

Detection

Check [Unreleased] section for:

Issue number reference (if commit has linked issue)
Keywords from commit message
Feature/component names

Impact Assessment

Impact	Criteria
High	New feature, breaking change, significant bugfix
Medium	Enhancement, minor bugfix, performance improvement
Low	Edge case fix, minor polish
None	Refactor, internal cleanup, tests, docs-only

User-facing (High/Medium/Low) require issue + CHANGELOG. None = skip.

Issue Creation

Same workflow as /create-issue: duplicate detection, user confirmation, no auto-creation.

After creating: gh issue comment <num> --body "Closed by <commit_sha>"

Progress Display

Auditing commits: <tag>..HEAD

Summary:
- Total commits: 25
- User-facing: 12 (missing issue: 3, missing CHANGELOG: 5)
- Not user-facing: 13 (skipped)

Then ask: "Process these commits? (create issues / update CHANGELOG / both / skip)"

Safety

Describe behavior, not implementation — issues are public and their readers are users, so no code snippets, diffs, or internal details
NEVER create labels without user confirmation
NEVER auto-create issues or edit CHANGELOG without user confirmation