commit（提交）

Commit

Overview

Create safe, structured commits with deterministic checks and consistent message quality. Run a guard before staging, then commit using Conventional Commits with a descriptive subject and required body bullets.

Path Resolution (Mandatory)

• Resolve any relative path in this skill from this skill directory, not from the caller's current working directory.
• For this skill, set skill_dir to the directory that contains this file (commit/SKILL.md), then use skill_dir/scripts/precommit_guard.py.
• Do not search for scripts/precommit_guard.py at repo root.

Workflow

1. Run safety guard:

- python3 <skill_dir>/scripts/precommit_guard.py

1. Abort immediately if the guard exits non-zero.

- Do not run git add or git commit when blocked.

1. Stage all changes only after guard passes:

- git add. -A

1. Review staged changes:

- git diff --cached --name-only - git diff --cached --stat

1. Compose commit subject and body using the format rules below.
2. Execute commit:

- git commit -m "<subject>" -m "<body>"

Safety Guard Rules

Abort when any path matches one of these conditions:

1. Log-like files:

• *.log, *.out, *.err
• npm-debug.log*, yarn-debug.log*, yarn-error.log*, pnpm-debug.log*
• any file under a logs/ directory

1. Untracked high-risk binary extensions:

• .exe, .dll, .so, .dylib, .bin, .class
• .zip, .tar, .gz, .bz2, .xz, .7z, .rar, .jar
• .iso, .dmg, .db, .sqlite, .sqlite3

If blocked, list offending files grouped by reason and request user action. Do not auto-delete files.

Commit Message Format

Use Conventional Commits subject:

• <type>(<scope>): <description>
• Scope is optional, but prefer it when clear.
• Subject must describe what changed (not only intent), be imperative, and avoid trailing period.
• Keep subject concise (prefer <= 72 chars).

Allowed type values:

• feat, fix, refactor, docs, test, chore, build, ci, perf, style, revert

Require commit body:

• Provide bullet lines summarizing key changes and impact.
• Mention migration/risk notes when relevant.
• Use concise, factual bullets.

Example:

Subject:

• fix(auth): handle token refresh race in session middleware

Body:

• - Serialize refresh attempts per user session to prevent duplicate refresh calls.
• - Add timeout handling so failed refresh does not block subsequent requests.
• - Update session middleware tests for concurrent request scenarios.

Execution Notes

• Prefer one logical commit for the current request.
• If changes are unrelated, split into separate commits and repeat the guard + staging flow for each.
• If message quality is uncertain, summarize staged diff first, then derive subject/body.