SKILL.md

name: git-conventions description: Git workflow and commit conventions

Git Conventions

Commit Message Format

Conventional Commits

<type>(<scope>): <subject>

<body>

<footer>

Types

Type	Description
`feat`	New feature
`fix`	Bug fix
`docs`	Documentation only
`style`	Formatting, no code change
`refactor`	Code change, no feature/fix
`perf`	Performance improvement
`test`	Adding/fixing tests
`chore`	Maintenance tasks

Examples

feat(orders): add batch order processing

Implements bulk order creation endpoint for high-volume channels.
Supports up to 100 orders per request with validation.

Closes #123

fix(beam): handle null variant mapping

Prevents NPE when Shopify returns product without variants.
Adds null check before accessing variant list.

Branch Naming

Format

<type>/<ticket>-<short-description>

Examples

feat/BEAM-123-batch-product-sync
fix/PRISM-456-checkout-validation
chore/INF-789-update-dependencies

Types

feat/ - New features
fix/ - Bug fixes
chore/ - Maintenance
docs/ - Documentation
refactor/ - Code refactoring
test/ - Test additions

Pull Request Guidelines

Title Format

[TICKET-123] Brief description of change

PR Template

## Summary
[1-3 sentences describing what this PR does]

## Changes
- Change 1
- Change 2

## Testing
- [ ] Unit tests added/updated
- [ ] Integration tests pass
- [ ] Manual testing completed

## Screenshots (if UI)
[Add screenshots for UI changes]

## Related Issues
Closes #123

PR Checklist

Code follows project conventions
Tests pass locally
Documentation updated
No secrets in code
Reviewed own changes before requesting review

Merge Strategy

Squash and Merge (Preferred)

Use for feature branches
Creates clean linear history
Squash message should summarize all commits

Rebase and Merge

Use when individual commits are meaningful
Each commit should be atomic and pass CI

Never Direct Push to Main

All changes through PRs
Require at least one approval
CI must pass

Conflict Resolution

Steps

Fetch latest main: git fetch origin main
Rebase your branch: git rebase origin/main
Resolve conflicts in each file
Continue rebase: git rebase --continue
Force push: git push --force-with-lease

Tips

Keep branches short-lived
Sync with main frequently
Communicate with team about large refactors

スコア

総合スコア

45/100

リポジトリの品質指標に基づく評価

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

○言語

プログラミング言語が設定されている

0/5

○タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です