Skills

Git Workflow with Conventional Commits

Installation
SKILL.md

📝 Git Workflow with Conventional Commits

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐⭐⭐ (P0 Level) Purpose: Conventional Commits準拠のGitワークフロー自動化

📋 概要

Conventional Commits仕様とMiyabiのPRガイドラインに従った 完全なGitワークフロー自動化を提供します。

🎯 P0: 呼び出しトリガー

トリガー 例
コミット "commit these changes"
PR作成 "create a PR"
マージ "merge this branch"
機能完了後 "after completing feature"
レビュー対応後 "after review feedback"

🔧 P1: Conventional Commits形式

コミットメッセージ構造

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

<body>

<footer>

Type一覧（優先順位順）

Type 用途 頻度 例
feat 新機能 高 feat(auth): add OAuth2 login
fix バグ修正 高 fix(api): resolve null pointer
docs ドキュメント 中 docs(readme): update install guide
refactor リファクタリング 中 refactor(parser): simplify logic
test テスト 中 test(unit): add auth tests
chore メンテナンス 低 chore(deps): update tokio
style フォーマット 低 style(lint): fix clippy warnings
perf パフォーマンス 低 perf(db): add index
ci CI/CD 低 ci(workflow): add clippy check
build ビルド 低 build(cargo): update Cargo.lock
revert リバート 稀 revert: feat(auth)

Scope一覧

Scope 対象
auth 認証・認可
api APIエンドポイント
db データベース
ui ユーザーインターフェース
cli コマンドライン
agent Agentシステム
worktree Worktree管理
deps 依存関係

🚀 P2: ワークフロー別パターン

Pattern 1: 標準コミット

# Step 1: 状態確認
git status && git diff --name-status

# Step 2: ステージング
git add <files>

# Step 3: コミット（HEREDOC必須）
git commit -m "$(cat <<'EOF'
feat(agent): add CodeGenAgent implementation

Implement CodeGenAgent for AI-driven code generation:
- Add BaseAgent trait implementation
- Support for Rust, TypeScript, Python
- Automatic test generation

Closes #270

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

# Step 4: プッシュ
git push -u origin feature/270-codegen-agent

Pattern 2: PR作成

# GitHub CLI使用
gh pr create \
  --title "feat(agent): Issue #270 - Add CodeGenAgent" \
  --body "$(cat <<'EOF'
## Summary
Implements CodeGenAgent for AI-driven code generation.

## Changes
- ✅ Add `crates/miyabi-agents/src/codegen.rs`
- ✅ Implement BaseAgent trait
- ✅ Add unit tests (85% coverage)

## Test Plan
- [x] Unit tests pass
- [x] Clippy warnings resolved
- [x] Format check passed

## Related Issues
Closes #270

## Quality Report
- **Score**: 85/100 ✅
- **Coverage**: 85%

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)" \
  --draft

Pattern 3: マージ戦略

戦略 コマンド 用途
Squash（推奨） gh pr merge --squash --delete-branch 大半のPR
Merge gh pr merge --merge --delete-branch 大規模機能
Rebase gh pr merge --rebase --delete-branch 単一コミットPR

⚡ P3: ブランチ命名規則

形式

<type>/<issue-number>-<brief-description>

例

Type 例
feature feature/270-codegen-agent
fix fix/271-worktree-race-condition
docs docs/272-update-skills
refactor refactor/273-cleanup-types
test test/274-add-integration-tests
chore chore/275-update-deps

📊 Worktree固有ワークフロー

Worktree作成からマージまで

# Step 1: Worktree作成
git worktree add .worktrees/issue-270 -b feature/270-codegen-agent

# Step 2: Worktree内で作業
cd .worktrees/issue-270
# ... 変更 ...
git add .
git commit -m "feat(agent): add CodeGenAgent"

# Step 3: プッシュ
git push -u origin feature/270-codegen-agent

# Step 4: PR作成
gh pr create --title "feat(agent): Issue #270" --draft

# Step 5: クリーンアップ（マージ後）
cd ../..
git worktree remove .worktrees/issue-270
git push origin --delete feature/270-codegen-agent
git branch -d feature/270-codegen-agent

🛡️ エラーハンドリング

Pre-commit Hook対応

# Hook変更確認
git status

# Hook変更をamend
git add .
git commit --amend --no-edit
git push --force-with-lease

マージコンフリクト

# コンフリクト確認
git status
git diff

# 解決後
git add <resolved-files>
git merge --continue
# または
git rebase --continue

誤ったブランチへのコミット

# 最後のコミット取り消し（変更は保持）
git reset --soft HEAD~1

# 正しいブランチへ移動
git checkout correct-branch

# 再コミット
git add .
git commit -m "Your message"

シークレットの誤コミット

# ファイルをコミットから削除
git rm --cached path/to/secret-file
git commit --amend --no-edit
git push --force-with-lease

# 古いコミットの場合: git-filter-repo使用

✅ チェックリスト

コミット前

  • テスト合格 (cargo test)
  • Clippy警告なし (cargo clippy)
  • フォーマット済み (cargo fmt)
  • シークレットなし
  • Conventional Commits準拠
  • 変更がIssue要件に一致
  • ドキュメント更新（必要時）

PR作成前

  • タイトルが規約に準拠
  • 説明が完全
  • CI合格
  • コンフリクトなし
  • レビュアー割り当て
  • ラベル付与
  • Issue紐付け (Closes #XXX)

🔗 関連ドキュメント

ドキュメント 用途
agents/specs/coding/pr-agent.md PRAgent仕様
docs/WORKTREE_PROTOCOL.md Worktreeプロトコル
docs/LABEL_SYSTEM_GUIDE.md ラベルシステム
.gitignore 除外ファイル

📝 関連Skills

  • Agent Execution: Worktree経由のブランチ作成
  • Rust Development: コミット前テスト
  • Issue Analysis: コミットtype/scope決定
Related skills

More from shunsukehayashi/miyabi-claude-plugins

Installs
–
Repository
shunsukehayashi…-plugins
GitHub Stars
31
First Seen
–
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykPass