git-workflow-automation

Automate Git workflow preflight checks and 2-commit strategy enforcement.

1|Updated Nov 13, 2024
One-click install
npx skills add https://github.com/vincent-kk/albatrion --skill git-workflow-automation-vincent-kk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow-automation
Source: https://github.com/vincent-kk/albatrion/tree/main/.claude/skills/git-workflow-automation
Command: npx skills add https://github.com/vincent-kk/albatrion --skill git-workflow-automation-vincent-kk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes Git workflow management to reduce manual friction, ensures a predictable commit history with a 2-commit per task approach, and helps prevent merge conflicts through automated preflight checks and safer operations.

Core Features & Use Cases

  • Preflight environment validation: automatically verifies tooling (nvm/git/yarn), branch state, and dependencies before work begins.
  • 2-commit strategy enforcement: guarantees one feature/implementation commit and one documentation/notes commit per task.
  • Automated Conventional Commit messages: generates standardized messages with appropriate scope and type.
  • Progress reporting & safe recovery: provides phase-based progress updates and clear rollback/recovery guidance during conflicts.
  • Use Case: for a task defined in 03_plan.md (e.g., 2.3), implement the feature in a dedicated commit, then document it in a separate docs commit, maintaining a clean history.

Quick Start

Use this skill to set up the environment, generate consistent commits, and follow a guided workflow to complete a task.

  • Run the preflight setup: ./tools/git_setup.sh
  • Generate commits for a task: ./tools/commit_generator.sh 2.3 feature
  • Stage and commit according to the generator output
  • Push and review through your standard PR process

Frequently Asked Questions about git-workflow-automation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce a structured conventional commits workflow in Git?

Enforce conventional commits by automating a 2-commit strategy per task, generating standardized messages with appropriate scope and type to maintain a predictable Git history. This prevents merge conflicts through automated preflight checks.

What is a 2-commit strategy for Git workflow automation?

A 2-commit strategy guarantees one feature commit and one documentation commit per task. This phase-based approach separates implementation from documentation to standardize Git workflow management and ensure a clean history.

How do I automate preflight environment validation for Git branches?

Automate preflight environment validation by running setup scripts to verify tooling like nvm, git, and yarn. This checks branch state and dependencies before work begins, ensuring a safer development environment.

Can I generate conventional commit messages from a task plan file?

Yes, generate conventional commit messages from a task plan file like 03_plan.md. By passing the task identifier to a generator script, the system outputs standardized commit messages for your feature and documentation commits.

What is the best way to prevent merge conflicts during automated Git commits?

The best way to prevent merge conflicts is executing preflight checks and safer operations before committing. Automated workflow management validates branch state and dependencies, providing clear rollback guidance during conflicts.

What should I do if a phase-based Git commit sequence fails?

If a phase-based Git commit sequence fails, follow the provided progress reporting and safe recovery guidance. The workflow validates the commit sequence and offers clear rollback instructions to safely recover during conflicts.