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

audit-commits

GitHub

审计代码提交，识别面向用户的变更，检查关联Issue和CHANGELOG条目，评估影响并生成报告。

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

触发场景

需要审查版本发布内容检查提交是否遗漏文档或问题链接自动生成或更新CHANGELOG

安装

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

更多选项

非标准路径

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

不安装直接使用

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)"