跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

commit

Standardized commit workflow with pre-flight checks, auto-format, and retry logic for pre-commit hooks

mrveiss · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add mrveiss/AutoBot-AI --skill commit

技能说明


name: commit description: Standardized commit workflow with pre-flight checks, auto-format, and retry logic for pre-commit hooks

Commit Workflow

Self-healing commit sequence that formats, stages, commits, and verifies — retrying up to 3x on hook failures.

Step 1 — Pre-flight state check

git branch --show-current        # Must NOT be release/main directly
git status                       # Identify all modified/untracked files
git diff --staged --name-only    # What's already staged?
git stash list                   # Warn if stashes exist

If on release or main directly: STOP and ask user.

Step 2 — Auto-format Python files

For every .py file that will be committed:

BLACK=$HOME/.cache/pre-commit/repoefsi1klb/py_env-python3/bin/black

for FILE in $(git diff --staged --name-only | grep '\.py$'); do
    $BLACK --line-length=88 "$FILE"
    isort --profile=black --line-length=88 "$FILE"
    git add "$FILE"    # Re-stage after formatting
done

Skip if no .py files are being committed.

Step 3 — Stage files

Stage only files relevant to the current issue. Never git add . blindly.

git add <file1> <file2> ...   # Preferred: explicit files
# OR
git add -u                     # All tracked modifications (safe if worktree is clean)

# Verify:
git diff --staged --name-only
git diff --staged --stat

If unrecognized files appear staged: git restore --staged <file>

Step 4 — Commit with retry loop

Attempt up to 3 times, fixing hook failures between attempts:

for ATTEMPT in 1 2 3; do
    echo "Commit attempt $ATTEMPT/3..."

    git commit -m "$(cat <<'MSG'
<type>(scope): <description> (#issue-number)
MSG
)" && echo "✅ Committed on attempt $ATTEMPT" && break

    # Hook failed — re-stage any files hooks modified
    echo "⚠️  Hook failed. Re-staging modified files..."
    git add -u
done

NEVER use --no-verify. Fix the underlying issue.

Step 5 — Post-commit verification

git log -1 --stat        # Verify commit landed
git diff                 # Nothing left uncommitted
git diff --staged        # Nothing accidentally staged

Step 6 — Report

State commit hash, files changed, branch, and whether more commits are needed.

Commit Message Format

<type>(scope): <description> (#issue-number)

Types: feat · fix · refactor · test · docs · chore · perf

Common Hook Failures & Fixes

HookSymptomFix
black"reformatted X.py"git add -u and retry
isort"Imports are incorrectly sorted"isort --profile=black <file> && git add <file>
flake8"E501 line too long"Shorten the line, git add <file>
autoflakeremoved unused importAccept it, git add -u
warn-untracked-filesuntracked source files detectedRun git diff --cached --name-only, verify staged files belong on this branch