Commit Pr

Commit & PR Skill

Commit Messages

Formato

<type>(<scope>): <description>

[optional body]

[optional footer]

Types

Scope

Módulo o área afectada: cli, ai, git, state, engine, etc.

Ejemplos

feat(cli): add --resume flag to work command

fix(ai): handle timeout in SDK provider gracefully

refactor(engine): extract CI handler to separate module

test(git): add worktree creation tests

Pull Requests

Título

Mismo formato que commits: <type>(<scope>): <description>

Template de Descripción

## Summary
- Bullet point 1 del cambio principal
- Bullet point 2 si aplica
- Bullet point 3 si aplica

## Test Plan
- [ ] Tests unitarios pasan
- [ ] Tests de integración pasan
- [ ] Probado manualmente con: [descripción]

## Related
- Closes #123 (si aplica)
- Related to #456 (si aplica)

Labels Recomendados

• enhancement - Nueva feature
• bug - Bug fix
• documentation - Solo docs
• refactor - Refactoring
• breaking-change - Breaking changes

Workflow de Git

Crear Branch

# Formato: oss-agent/<issue-id>-<descripcion-corta>
git checkout -b oss-agent/123-add-resume-flag

Antes de Commit

# Verificar cambios
git status
git diff

# Stage archivos específicos (preferido sobre git add .)
git add src/cli/commands/work.ts
git add tests/work.test.ts

Commit

git commit -m "feat(cli): add --resume flag to work command

Allows resuming work on a previously started issue session.
The session ID is retrieved from the state database.

Closes #123"

Push y PR

# Push branch
git push -u origin oss-agent/123-add-resume-flag

# Crear PR
gh pr create --title "feat(cli): add --resume flag" --body "..."

Ver CONVENTIONS.md para convenciones específicas del proyecto.