B3 git commit

Skill jporre/sveltekit-verticalslices/skills/b3-git-commit

Commits en formato conventional commits: analiza el diff, agrupa cambios en commits lógicos y garantiza working tree limpio al terminar. Usar cuando el usuario pida commitear, o cuando otro skill del pipeline b (b2/b7/b8/b9/b10) necesite crear commits.From its SKILL.md

Install

npx -y skills add jporre/sveltekit-verticalslices --skill b3-git-commit

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.5 KB, as published. Nobody here has run it

Git Commit with Conventional Commits

Argumentos recibidos

$ARGUMENTS

Opcional: número de issue (ej 262 o #262). Si viene, agregar footer Refs #N al commit principal (o Closes #N si el usuario lo pide explícitamente — en el flujo b el Closes vive en el PR, no en el commit).

Workflow

1. Analyze Diff

# If files are staged, use staged diff
git diff --staged

# If nothing staged, use working tree diff
git diff

# Also check status
git status --porcelain

2. Stage Files (if needed)

If nothing is staged or you want to group changes differently, stage the files for each logical commit.

Never commit secrets (.env, credentials.json, private keys).

3. Generate Commit Message

Analyze the diff to determine:

Type: What kind of change is this?
Scope: What area/module is affected?
Description: One-line summary of what changed (present tense, imperative mood, <72 chars)

Update CHANGELOG.md with user-facing changes (incluirlo en el commit que corresponda).

4. Execute Commit

# Single line
git commit -m "<type>[scope]: <description>"

# Multi-line with body/footer
git commit -m "$(cat <<'EOF'
<type>[scope]: <description>

<optional body>

<optional footer>
EOF
)"

If commit fails due to hooks, fix and create NEW commit (don't amend).

5. Verificación final (OBLIGATORIO — no saltar)

El skill NUNCA termina con working tree sucio. Como último paso, SIEMPRE correr:

PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cat "$HOME/.claude/b-pipeline.root" 2>/dev/null || ls -d "$HOME"/.claude/plugins/marketplaces/b-pipeline* 2>/dev/null | head -1)}"
bash "$PLUGIN_ROOT/skills/b1-add-worktree/scripts/assert-clean.sh" . --fix

Según exit code:

0 → limpio, terminado. Probar que los commits aterrizaron — pegar la salida CRUDA de git log --oneline -n <k> (los k commits creados en este run) y terminar SIEMPRE con la línea machine-readable:
```
B3_DONE commits=<n> head=<sha-corto>
```
Si git log no muestra el commit prometido, el run NO terminó — jamás reportar un commit sin su SHA en la evidencia (un commit fantasma deja el tree sucio y corta el pipeline entero en el próximo preflight). Los orquestadores (b7/b9/b10) parsean esta línea igual que B7_DONE/B9_MERGED.
6 (código sin commitear) → los archivos listados bajo --- CODIGO --- pertenecen al cambio: stagearlos y commitearlos (en el commit lógico que corresponda, o un commit extra chore: incluir archivos restantes del cambio). Re-correr la verificación. Repetir hasta exit 0. PROHIBIDO terminar reportando éxito con exit 6.
7 (artefactos que --fix no pudo excluir, ej. tracked/staged) → reportarlos al usuario con el listado; no descartarlos.
2 (invocación inválida / el directorio no es repo git) → abortar reportando el error textual; no reintentar ni dar el commit por verificado.

Este gate existe porque cambios fuera del commit bloquean el worktree y detienen el flujo b completo (b9-close no puede cerrar). El productor de commits garantiza el tree limpio, no el consumidor.