miica-git

このコマンドは集中的なgitワークフロー作業に使用します。

miica-se ポスチャーは常に有効です。実際のgit状態を確認してから動作します。

目標

最小限で正確なgitワークフロー ステップを実行します: ブランチの作成、1つ以上の小さくまとまったコミットの作成、またはGitHub プルリクエスト下書きの作成です。

インテント ルーティング

ユーザーのリクエストからインテントを推測します。

• branch: ユーザーが作業を開始したい、作業を分割したい、または変更を新しいブランチに移動したい場合に、新しいブランチを作成してチェックアウトします
• commit: ユーザーが作業を保存またはコミットしたい場合に、関連する変更をステージして、1つ以上の小さくまとまったコミットを作成します
• pr: ユーザーがPRのタイトル/本文、レビュー概要、またはブランチ概要が必要な場合に、GitHubプルリクエスト コンテンツの下書きを作成します

リクエストがあいまいな場合は、動作する前に短い質問を1つ尋ねます。

共通チェック

1. git status --short --branch を実行します。
2. 関連するdiffを確認します:
   • ワーキングツリーの変更については git diff と git diff --cached を実行
   • PR下書きの場合はベースブランチに対するブランチdiffを実行
3. コミットまたはPRの文言がリポジトリの履歴と一致すべき場合、git log --oneline -10 を実行します。
4. シークレット、認証情報、または無関係な変更のように見えるファイルをステージまたは含めません。

ブランチ モード

以下のブランチ ワークフローに従います:

1. ブランチの種類と簡潔な説明を解析または推測します。
2. 種類を正しいプリフィックスにマッピングします:

種類	プリフィックス
feature, feat	feature/
fix, bug	fix/
hotfix	hotfix/
docs	docs/
refactor	refactor/
chore	chore/
ci	ci/
test	test/
perf	perf/

3. 説明をフォーマットします:
   • 小文字
   • スペースをハイフンに置換
   • 特殊文字を削除
   • 簡潔に、可能であれば最大50文字
4. ブランチ名を <prefix><description> として構築します。
5. ブランチがまだ存在しないことを確認します。
6. 現在の HEAD からブランチを作成してチェックアウトします。
7. ブランチ名と作成元を出力します。

種類が認識できない場合は、サポートされている種類を表示し、ユーザーに選択を求めます。

コミット モード

以下のコミット ワークフローを使用します:

1. git status、git diff、git diff --cached を実行します。
2. コミットする変更がない場合、ユーザーに伝えて停止します。
3. diffを小さくまとまったスライスにグループ化します。可能な限り、無関係な作業、広範なリファクタリング、ドキュメント専用の変更を異なるコミットに分離します。
4. 現在のスライスのファイルのみをステージします。git add -A より明示的なファイルを優先します。
5. ユーザーがメッセージを提供し、作業が1つのスライスの場合、それを使用します。diffが明らかに複数のスライスにまたがる場合、1つの広いコミットを強要する代わりに、スライスごとにメッセージを導出します。
6. そうでなければ、現在のスライスに対してConventional Commitメッセージを作成します:

type(scope): short description

Optional body explaining why, not what.

ルール:

• サブジェクトは72文字未満
• 命令法
• 本文は必要な場合に理由を説明
• ユーザーが明示的に要求しない限り Co-Authored-By 行なし

7. そのスライスのコミットを作成してから、残りのスライスについて繰り返します。
8. git status を再実行して成功を確認します。
9. 作成された各コミットのコミット ハッシュとメッセージを出力します。

PR モード

以下のPR下書き ワークフローを使用します:

1. ベースブランチを決定します:
   • 利用可能な場合は明示的にユーザーが提供したベースを使用
   • そうでなければ origin/main を優先し、その次に main、その次に master
2. ブランチを以下で確認します:
   • git diff --stat <base>...HEAD
   • git diff <base>...HEAD
   • git log --oneline <base>..HEAD
3. 以下の内容でプルリクエスト コンテンツの下書きを作成します:
   • タイトル
   • 概要
   • 主な変更
   • テスト
   • リスクまたは未解決の質問
4. ワーキングツリーがダーティな場合、下書きが関連性がある場合、コミットされていない変更を含む可能性があることを記します。
5. 意味のあるdiffがない場合、ユーザーに伝えて停止します。

ユーザーが明示的に要求し、ローカル ツールと認証がそれを可能にする場合にのみ実際のGitHub プルリクエストを開きます。そうでなければPRコンテンツのみを返します。

ガードレール

• ユーザーが明示的に要求しない限り、reset、パスのチェックアウト、強制削除などの破壊的なgitコマンドを使用しません
• 操作をユーザーがリクエストしたgitタスクのスコープに保ちます
• 既存のコミットを静かに修正しません