About git-workflow
A Git collaboration skill that defines commit, branch, pull request, review, and AI-assisted coding practices. It is intended for development teams that need consistent repository workflows, including specific review and testing requirements for contract changes.
Key features
- 01Conventional Commits guidance
- 02Review changes before staging
- 03Feature branch naming patterns
- 04Pull request content requirements
- 05Code review and AI coding rules
Use cases
- 01Preparing changes for a commit
- 02Creating a feature or fix branch
- 03Opening a pull request with required details
- 04Reviewing AI-generated or contract upgrade code
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ 0xlayerghost/ solidity-agent-kit --skill git-workflowAfter installing, type/git-workflowin Claude Code to confirm it loaded.
Details
From the project READMEGit Collaboration Standards
Language Rule
- Always respond in the same language the user is using. If the user asks in Chinese, respond in Chinese. If in English, respond in English.
Commit Rules
Use Conventional Commits format: <type>: <short description>
| Type | When to use |
|---|---|
feat: | New feature or contract |
fix: | Bug fix |
refactor: | Code restructure without behavior change |
test: | Add or update tests |
docs: | Documentation changes |
chore: | Build config, dependency updates, toolchain |
security: | Security fix or hardening |
Commit Workflow
- Run
git diffto review all changes before staging - Stage specific files — avoid
git add .to prevent committing.envor artifacts - Write concise commit message describing the why, not the what
- Never add
Co-Authored-Bylines — commit messages should only contain the description - Only commit — never
git pushunless explicitly requested - Never push directly to main/master — always use feature branches
Branch Naming
| Pattern | Example |
|---|---|
feat/<name> | feat/staking-pool |
fix/<name> | fix/reentrancy-guard |
refactor/<name> | refactor/token-structure |
PR Requirements
Every PR must include:
| Section | Content |
|---|---|
| Change description | What was changed and why |
| Test results | forge test output (all pass) |
| Gas impact | forge test --gas-report diff for changed functions |
| Deployment impact | Does this affect deployed contracts? Migration needed? |
| Review focus | Specific areas that need careful review |
Code Review Rules
| Scenario | Requirement |
|---|---|
| Standard changes | Minimum 1 maintainer approval |
| Security-related changes | Minimum 2 maintainer approvals |
| AI-generated code | Must pass manual review + forge test before merge |
| Contract upgrades | Requires full team review + upgrade simulation on fork |
AI Assistance Rules
- AI-generated code must pass
forge testbefore committing - Always review AI output for: correct import paths, proper access control, gas implications
- Include relevant file paths and test cases in AI prompts for better results
- Run
forge fmtafter AI generates code to ensure consistent formatting
Comments
Markdown supported