Git Commit Smart

このスキルは、git コミット smart タスクの自動化を支援します。

前提条件

このスキルを使用する前に、以下を確認してください:

• Git リポジトリが {baseDir} に初期化されている
• git add を使用して変更がステージングされている
• ユーザーがコミットを作成する権限を持っている
• Git のユーザー名とメールアドレスが設定されている

手順

1. ステージングされた変更を分析: git diff の出力を検査して変更内容を理解する
2. コミットタイプを決定: 変更を feat、fix、docs、style、refactor、test、chore に分類する
3. スコープを特定: ファイルパスから影響を受けるモジュールまたはコンポーネントを抽出する
4. 破壊的変更を検出: API の変更、削除されたフィーチャー、または互換性のない変更を確認する
5. メッセージをフォーマット: type(scope): description パターンに従ってメッセージを構築する
6. レビュー用に提示: 生成されたメッセージを表示し、コミットする前に確認を求める

出力

以下のフォーマットで conventional commit メッセージを生成します:

type(scope): brief description

- Detailed explanation of changes
- Why the change was necessary
- Impact on existing functionality

BREAKING CHANGE: description if applicable

例:

• feat(auth): implement JWT authentication middleware
• fix(api): resolve null pointer exception in user endpoint
• docs(readme): update installation instructions

エラーハンドリング

よくある問題と解決策:

ステージングされた変更がない

• エラー: "No changes staged for commit"
• 解決策: コミットメッセージを生成する前に git add <files> を使用してファイルをステージングする

Git が初期化されていない

• エラー: "Not a git repository"
• 解決策: git init で git を初期化するか、リポジトリルートに移動する

コミットされていない変更がある

• 警告: "Unstaged changes detected"
• 解決策: 関連する変更をステージングするか、関連のない変更に対して git stash を使用する

無効なコミットフォーマット

• エラー: "Generated message doesn't follow conventional format"
• 解決策: メッセージをレビューして、タイプ、スコープ、または説明を手動で調整する

リソース

• Conventional Commits 仕様: https://www.conventionalcommits.org/
• Git コミットベストプラクティスドキュメント
• スタイル一貫性のためのリポジトリコミット履歴
• {baseDir}/000-docs/007-DR-GUID-contributing.md のプロジェクト固有コミットガイドライン

概要

このスキルは、説明された機能の自動化支援を提供します。

例

使用例パターンはコンテキスト内で説明されます。