AgentSkillsCN

git-commit-helper

根据已暂存的 Git 更改生成常规提交信息。在提交前，先对文件进行暂存操作。

SKILL.md
--- frontmatter
name: git-commit-helper
description: Generate conventional commit messages from staged git changes. Use after staging files before committing.
disable-model-invocation: true
allowed-tools: Read, Bash, Grep
argument-hint: "[optional scope override or hint]"

You are a git commit assistant.

Analysis Phase

  1. •Run git diff --cached --stat to see which files are staged.
  2. •Run git diff --cached to read the actual changes.
  3. •If nothing is staged, inform the user and stop -- do not generate a commit message for an empty changeset.
  4. •Identify the primary intent of the changes (new feature, bug fix, refactor, etc.).
  5. •Determine the scope from the file paths (e.g., auth, api, infra, docs).

Conventional Commit Format

Use this structure:

code
<type>(<scope>): <short summary>

<optional body>

<optional footer>

Types

TypeWhen to UseExample
featNew feature or capabilityfeat(auth): add OAuth2 login flow
fixBug fixfix(api): handle null user in /profile endpoint
refactorCode restructuring with no behavior changerefactor(db): extract query builder into module
choreTooling, dependencies, configchore(deps): upgrade express to 4.19
docsDocumentation onlydocs(readme): add deployment instructions
testAdding or updating teststest(auth): add unit tests for token refresh
styleFormatting, whitespace, semicolonsstyle(lint): apply prettier formatting
perfPerformance improvementperf(query): add index for user lookup
ciCI/CD configurationci(github): add caching to build workflow
buildBuild system or external depsbuild(docker): optimize multi-stage build

Summary Line Rules

  • •Imperative mood ("add", not "added" or "adds").
  • •Lowercase first letter after the colon.
  • •No period at the end.
  • •Maximum 72 characters.

Body (for non-trivial changes)

  • •Separate from summary with a blank line.
  • •Explain why the change was made, not what (the diff shows what).
  • •Wrap at 72 characters.

Footer

  • •Breaking changes: add BREAKING CHANGE: <description> footer.
  • •Issue references: Closes #123 or Fixes #456.

Handling Complex Changes

  • •If changes span multiple concerns (e.g., a feature + a refactor), prefer the primary intent for the type.
  • •If changes are truly unrelated, suggest splitting into multiple commits.
  • •For large diffs (> 50 files), summarize by area rather than listing every file.

Edge Cases

  • •Nothing staged: output "No staged changes detected. Stage files with git add first." and stop.
  • •Massive diff: summarize the high-level intent; do not attempt to describe every line.
  • •Merge commits: do not generate a conventional commit message for merge commits; they have their own format.
  • •Only deletions: use the appropriate type (refactor for dead code removal, chore for dependency removal).