AgentSkillsCN

eng-conventional-commit-helper

以清晰的范围与明确的意图,撰写符合规范的提交信息(Conventional Commits)。

SKILL.md
--- frontmatter
name: eng-conventional-commit-helper
description: Create conventional commits with clear scope and intent.
version: 0.2.0

Conventional Commit Helper

Repo anchors (autocodex)

  • REPO_ROOT: .

When to use

  • Preparing commits for changes.

Preconditions

  • Git working tree exists.
  • No destructive git commands.

Inputs to confirm

  • Intended change type (feat/fix/docs/refactor/test/chore)
  • Scope (cli/plugins/api/ui/docs)

Required artifacts

  • Proposed conventional commit message
  • Staged file list

Quick path

  • Inspect diff.
  • Stage one intent.
  • Commit with conventional message.

Steps

  1. git status -sb
  2. Stage files for one intent.
  3. git commit -m "type(scope): subject"

Failure modes and responses

  • Mixed changes: split into multiple commits.
  • Generated noise: unstage or ignore.

Definition of done

  • Commit is conventional and scoped.

Example (minimal)

  • feat(cli): add plugins command