トライアングルコミット
件名は次のようになります:
<エリア><振る舞いまたは意図>[修飾子] <チケット> (<スコープ>): <サマリー>
🧩👔 #412 (サーバー): 拒否から30日以内の異議申し立てを許可
🎨💄 — (トークン): Figmaから新しい色合いを取得
絵文字は行の最初の文字であり、その周囲には何もありません。最後の例はジョブによって行われたコミットです。チケットがないため、ダッシュ(—)が使用されています。
語彙は意図的に大きく、すべてを頭に入れておく必要はありません。gitmoji コマンドは少しずつ提供します。必要な部分だけを読んでください。
コマンド
gitmoji コマンドを使用します。PATHにない場合は、このスキルのフォルダにある references/vocabulary.txt を読み、コマンドがないことをユーザーに伝えてください。
| 状況 | 実行コマンド |
|---|---|
| エリアの一覧が必要な場合 | gitmoji guide areas |
| エリアがわかっている場合 | gitmoji guide 🧩(任意のエリア絵文字または名前) |
| エリアガイドに該当するものがない場合 | gitmoji guide groups、次に1つのグループ:gitmoji guide "repair" |
| 2つのエントリの両方が該当しそうな場合 | gitmoji guide 🛡️、またはグループ:gitmoji guide "protection" |
| 作業が試験的、一時的、または破壊的変更の場合 | gitmoji guide modifiers |
| スコープ名が必要な場合 | gitmoji guide scopes |
| サマリーまたはボディを書こうとしている場合 | gitmoji guide message |
git commit の前 | gitmoji staged、次に最初の行のために gitmoji check -m '<件名>'、またはメッセージ全体のために gitmoji check <ファイル> |
:jigsaw::necktie: のようなショートコードを入力した場合 | 何もしない:フックが絵文字を書き込む |
| コミットを元に戻す場合 | git revert <コミット>;git自身の最初の行はそのまま |
| フックが件名を拒否した場合 | そのメッセージを読む;修正内容が示されている |
| ブランチのコミットをマージ前に確認したい場合 | gitmoji history trunk..HEAD(マージ先のブランチ、次にあなたのブランチ) |
| フックがリポジトリが別のバージョンを採用したと表示した場合 | 指定されたアドレスで変更内容を読み、設定を変更する前にユーザーに伝える |
コードを書く前に:コミットを計画する
チケットを読み、作成予定の件名をリストとして書き出します。それぞれは、レビュアーが単独で受け入れられる決定であり、チケットが要求する内容です。各コミットのスコープは、その決定を所有するパッケージです(gitmoji guide scopes)。
これらはプロンプトであり、埋めるべきスタックではありません。チケットが質問に答えを与える場合にのみ、コミットを計画します:
- ビジネスは何を決定するか(
👔)、そして時間の経過とともに何が起こるか(⛓️)? - ステップを試みる前に何が拒否されるか(
🛡️)?ステップが失敗した場合、どのように回復し、どのエラーコードを報告し、人々に何を伝えるか(🥅)? - 部品間でどのような形状が合意されるか(
🏷️)、そして何が保存されるか(💾)? - ユーザーは何を見て何を行い、どのコミットで初めてそれを得るか(
✨)? - 実際の製品でユーザーがそれを通過できることをどのように確認するか(
✅、それ自身のコミット、製品がその方法で実行可能になったら追加)?
ジャーニーがまだ実行できない場合は、機能を出荷し、チケットに ✅ が未完了であることを記載します。ギャップを埋めるために小さいチェックに ✅ を入れないでください。それは ☑️ です。
新しいエンドポイント、ストア、またはポリシーを計画する前に、既存の所有者を確認してください。製品の決定が欠けており、それが何を出荷するかを変える場合は、質問を書き留めて尋ねてください。コミット内で解決しないでください。
1つの決定であり、その唯一の呼び出し元と必要なチェックのみを含む機能は、1つのコミットです。チケットがレビュアーが個別に取れる複数の決定を含む場合にのみ、より多くの行を計画します。チケットが要求しなかった行は細かすぎます。
各コミットの前:4つの質問
- 変更はどのエリアの一部ですか、またはどのエリアに関するものですか? テスト、ドキュメント、プレイグラウンドは、それらが対象とするもののエリアを取ります。
- 今は何が異なりますか、または何をしましたか? コミットが約束された内容を変更する場合は、振る舞い(名詞)を指定します。それ以外の場合は、意図(動詞)を指定します。
- 作業は確定していませんか? その場合のみ、3つ目の絵文字を追加します:
🧪試験的、🚧一時的、💥消費者は適応する必要があります。試験的なものは、🏁(採用)または⚰️(廃止)になるまで、すべてのコミットに🧪を保持し、それまでは確定したものはそれに依存してはいけません。チケットが選んだ方向に構築することは試験ではありません。 - どのチケットですか? リポジトリのチケット形式を使用します。ジョブのみが
—を書きます。
その後、gitmoji check -m '<件名>' を実行します。
ステージングする前に、変更をその場にいなかった誰かのように読みます。理由がコードから見えない場合は、コードの横にコメントを書きます:なぜそのようになっているのか、何を変更してはいけないのか、値がどこから来るのか。行が何をするかではなく、理由を述べてください。コメントはほとんどコストがかからず、次の読者(人、ジュニア、またはあなたのコンテキストを持たないエージェント)が推測する手間を省きます。
1つのペアが合わない場合
それは、最も近いタグを選ぶのではなく、再検討する合図です。
- 2つのラベルが合う場合、レビュアーが今受け入れられるものと、延期できるものを指定します。それらの2つの決定が異なり、保持されたものが単独で機能する場合に分割します。パスまたはハンクごとにステージングします(
git add -p)。 - 唯一の呼び出し元、その配線、および必要な拒否チェックは、それらのどれも独自の約束を持たない場合、まとめて保持します。コミットにそのポイントでタグを付けます;残りは付随します。
gitmoji stagedは2つのスコープを報告します:同じ質問をします。変更が全体としてのみ意味をなす場合(例:2つの言語でミラーリングされた1つの形状)、まとめて保持し、決定を所有するパッケージを指定します。- メインの変更によって強制される部分は付随します:その型、テスト、ストーリー、ロックファイル。
各コミットはそれ自体でビルドおよびパスする必要があります。分割がそれを壊す場合は、強制された部分をまとめて保持し、ボディでその旨を述べてください。
書き方
- サマリー: システムが今何をするかを、ドメインの言葉で、小文字の動詞で始めます。最初の行全体は、絵文字、チケット、スコープを含めて140文字以内に収め、短いほど良いです;
gitmoji check -m '<件名>'はコミット前に文字数をカウントします。ファイル名、チケット番号、「どのように」は含めません。 - 説明: あなたが書くすべてのコミットに説明があり、フックは説明なしのコミットを拒否します。マーカーのみ(
🔖、🔺)、ジョブによるコミット、およびgitが書いたメッセージのみが説明を必要としません。最初の行の後、空行、次に変更が行われた理由:理由、なぜこの方法で、明白な方法ではないのか、または選んだ値。通常は1行か2行で十分です;最大でも6行です。チケット参照は文の中に保持します(例:「決定については #42 を参照」)。誰かがコミットを編集するときにgitは#42で始まる行を削除できます。diffを再記述したり、ファイルをリストしたり、自分のプロセスを説明したりしないでください。 - 絵文字、ショートコードではない。 コミットされるのは文字だけです。
誰が書いたか
自分自身を作者または共同作者として追加しないでください。 Co-Authored-By: 行、git config user.* または --author にエージェントのアイデンティティを設定しないでください。作者は責任者であり、フックはそこにエージェントを拒否します。一部のツールは、求められなくても自分自身の共同作者行を追加します;フックがそのためにコミットを拒否した場合は、その行を削除して再度コミットしてください。
代わりに、ボディを空行で終了し、コミットに何が関わったかを示す署名を追加します:
_
example-model (high), editor
Claude Code (example-session)
Sub-agents: 2 × example-helper (medium)
Team: reviewer, tester
Research: 3 searches, 12 pages
最初の3行は常に存在します。最後の3行は該当する場合のみ表示されます。コミットが行われるとき、フックはアンダースコアを △ と、バッククォートで囲まれたメッセージがチェックされた語彙のバージョンに置き換えるため、保存された署名は次のようになります:
△ `1.2.3`
example-model (high), editor
Claude Code (example-session)
アンダースコアを書いてください;自分で △ 行を書かないでください。フックはすべてのメッセージをそれで閉じます(人のメッセージも同様で、その場合はその1行のみで署名はありません)。gitmoji history はそれを読み取って、どのコミットがどのバージョンかを判断します。
プロジェクトは [rules] の下で signature = "agents" を設定して、サポートされているエージェントセッションがコミットフックを実行するときにモデル行とハーネス行を必須にすることができます。人間は通常の説明でコミットできます。リリースマーカーとGitによって生成されたメッセージは、既存の例外を保持します。
| 行 | 内容 |
|---|---|
_ | 署名がここから始まります。フックはこれを △ `<バージョン>` に変換します。 |
| モデル行 | モデルとその努力。カンマの後に、あなたの名前(人があなたに与えた場合のみ)。 |
| ハーネス行 | ハーネスと、括弧内のセッションID(存在する場合)。 |
Sub-agents: | このコミットの作業の一部を行ったサブエージェントの数(モデルと努力別)。 |
Team: | このコミットのためにメッセージを交換した他のエージェント。 |
Research: | このコミットのためのウェブ検索、読んだページ、ドキュメントルックアップ。 |
これを記憶から書かないでください。 このスキルのフォルダ内の scripts/ にあるハーネス用のスクリプトを実行し、出力を貼り付けてください。パスはこのファイルがあるフォルダからの相対パスで、スキルがインストールされている場所です:
python3 scripts/claude-code.py
Claude Codeでは、そのフォルダは ${CLAUDE_SKILL_DIR} です。スクリプトはハーネス自身のセッション記録を読み取ります。そこにハーネス用のスクリプトがない場合、scripts/README.md に一度作成して追加する方法が書かれています。記録が見つからない場合、スクリプトは unknown を出力します。リポジトリは、セッションIDなどの行を省略するよう求める場合があります;その指示に従ってください。
セッションが複数のタスクやリポジトリにまたがる場合は、オプションのアクティビティ行をこのコミットに対して確認してください。このコミットに帰属できる貢献のみを保持してください。
ボディに含めることができる行
🩹にはLimitation: <依存関係ができないこと>が必要です。📥にはSource: <それが来た実行、ツール、またはシステム>が必要です。🏁と⚰️は何がそれを決定したかを述べます。🐛は原因を指定できます:Broken-by: <sha>。
Gitmojiのアップグレード時
CLI、スキル、語彙はリリース番号を共有します。フックは、リポジトリの設定がコマンドが話すものとは別のバージョンを指定している場合に警告します。ユーザーに伝え、警告が示すアドレスで変更内容を読んでください。ユーザーが新しいバージョンを希望する場合、[vocabulary] の下で設定にそれを設定し、それだけをコミットし、バージョンをバッククォートで囲みます:
🔺 gitmoji `<バージョン>`: <このリポジトリに対する変更内容>
ユーザーが要求しない限り、すでに共有されている履歴を書き換えないでください:古いルールの下で作成されたコミットはそのままでも構いません。gitmoji history --unmigrated は今日パスしないものを表示します。ピンを変更した後は gitmoji init を実行して、インストールされたスキルと管理されたワークフローを更新してください。
プルリクエストのマージと履歴のアップグレード
PRタイトルワークフローを有効にし、デフォルトのマージメッセージとして Pull request title and description を選択します。人間がタイトルを書きます。Gitmojiはコミットが変更されるにつれて絵文字プレフィックスを維持します。Create a merge commit を提案されたメッセージで使用します。GitHubは作成されたコミットを保持し、統合するPR番号を追加します。
既存の履歴については、アップグレードガイドとインストールされた scripts/gitmoji-upgrade-history.py を使用します。ローカル候補を作成する前にドライランを検査してください。リンクにはどのPRがマージされたかの証拠が必要です。共有ブランチの置き換えは、リポジトリ所有者の別の決定です。
Gitが書くメッセージ
マージは任意のタイトルを持つことができます。フックは保留中のマージ中にGitのメッセージファイルを保持し、gitmoji history は複数の親を持つ保存されたマージを認識します。テキストのみの check -m は、作業するための件名のみを持ちます。通常のGitブランチ、タグ、コミットマージ見出し、GitHubプルリクエストマージ見出し、番号付き Merge #N キャプション、引用されたGit revertおよびreapply件名、番号付き Revert #N および Reapply #N キャプション(タイトル付き)、Gitのデフォルトのsquashログ見出し、およびautosquashプレフィックス fixup! 、squash! 、amend! を認識します。
カスタムPRタイトルを持つスカッシュマージは、通常の1つの親を持つコミットを生成します。Cherry-pickとrebaseも通常の件名を引き継ぐことができます。それらは他の作成されたコミットと同様にチェックしてください。PR番号だけではマージを識別しません。
導入中、プロジェクトは gitmoji.toml で [rules] → untagged = "warn" を設定して、プレーンな件名を受け入れ、レビューのためにフラグを立てることができます。デフォルトは "error" です。"off" の場合、欠落したタグは静かに受け入れられます。他のチェックは引き続き適用されます。共有する前に言い換える件名を見つけるために、ブランチで gitmoji history trunk..HEAD を使用してください。履歴は常にタグなしの件名を厳密にチェックします。
何も合わない場合
エントリを曲げないでください。最も近い正直なものを使い、ボディ行 Miss: <言いたかったこと> を追加し、ユーザーに伝えてください。Missは語彙が修正される方法です。