コミットメッセージのフォーマット

プロジェクト標準に従い、適切な帰属表記付きで規約に基づいたコミットメッセージを生成します。

権限: コミットフォーマットは docs/COMMIT_CONVENTIONS.md (Conventional Commits + Release Please ルール) に従う必要があります。Release Please が使用されているため、Release Please とチェンジログ生成が正しく解析されるよう、すべてのコミットでこのスキルを使用してください。

使用する場合

• リリースコミット
• 自動バージョン更新
• リファクタリングコミット
• 一貫したフォーマットが必要なコミット
• ドキュメント更新

手順

ステップ 1: コミット情報を収集

コミットメッセージに必要な情報を収集します。

期待される入力:

• type: 文字列 (feat|fix|chore|docs|refactor|test|style|perf)
• scope: 文字列 (オプション、例: "auth"、"api"、"ui")
• description: 文字列 (簡潔な説明)
• body: 文字列 (オプション、詳細な説明)
• breaking: ブール値 (オプション、これは破壊的な変更か?)

ステップ 2: メッセージをフォーマット

プロジェクト標準で規約に基づいたコミットフォーマットを適用します。

フォーマット構造:

{type}({scope}): {description}

{body}

{footer}

フッターテンプレート:

🤖 Generated with [Codex](https://Codex.com/Codex)

Co-Authored-By: Codex <noreply@anthropic.com>

破壊的な変更: breaking: true の場合、本文の先頭に "BREAKING CHANGE: " を付けるか、フッターに追加します。

ステップ 3: メッセージを検証

メッセージがガイドラインに従っていることを確認します。

検証ルール (Release Please 対応):

• タイプは有効である必要があります (feat|fix|chore|docs|refactor|test|style|perf|ci)
• サブジェクト: 命令形、小文字、末尾にピリオドなし、72 文字以下
• スコープ: 存在する場合は小文字; 通常のコミットに chore(release): を使用しないこと (Release Please のみ使用可能)
• 本文: 存在する場合は 72 文字で折り返す
• 破壊的: 本文/フッターで BREAKING CHANGE: を使用するか、サブジェクトで type! / type(scope)!: を使用する

ステップ 4: フォーマットされたメッセージを返却

git commit に使用できる完全なコミットメッセージを返却します。

期待される出力:

feat(auth): add OAuth2 authentication support

Implemented OAuth2 flow with token refresh and secure storage.
Supports Google and GitHub providers.

🤖 Generated with [Codex](https://Codex.com/Codex)

Co-Authored-By: Codex <noreply@anthropic.com>

エラーハンドリング

• 無効なタイプ: 有効なタイプ一覧を含むエラーを返却
• 説明が欠落: 説明を要求するエラーを返却
• 説明が長すぎる: 文字数を含むエラーを返却
• 無効なフォーマット: フォーマットの問題を説明

例

例 1: シンプルなフィーチャーコミット

入力:

{
  "type": "feat",
  "description": "add dark mode toggle"
}

出力:

feat: add dark mode toggle

🤖 Generated with [Codex](https://Codex.com/Codex)

Co-Authored-By: Codex <noreply@anthropic.com>

例 2: スコープ付き修正とボディ

入力:

{
  "type": "fix",
  "scope": "api",
  "description": "resolve memory leak in connection pool",
  "body": "Connection pooling was not properly releasing connections after timeout. Implemented automatic cleanup and connection recycling."
}

出力:

fix(api): resolve memory leak in connection pool

Connection pooling was not properly releasing connections after
timeout. Implemented automatic cleanup and connection recycling.

🤖 Generated with [Codex](https://Codex.com/Codex)

Co-Authored-By: Codex <noreply@anthropic.com>

例 3: 破壊的な変更

入力:

{
  "type": "feat",
  "scope": "api",
  "description": "migrate to v2 authentication API",
  "breaking": true,
  "body": "Updated authentication to use new v2 endpoints with improved security."
}

出力:

feat(api): migrate to v2 authentication API

BREAKING CHANGE: Updated authentication to use new v2 endpoints with
improved security. All clients must update authentication tokens.

🤖 Generated with [Codex](https://Codex.com/Codex)

Co-Authored-By: Codex <noreply@anthropic.com>

例 4: リリースコミット (自動化のみ)

注記: chore(release): コミットは、リリーススクリプトまたは Release Please によってのみ作成される必要があります。エージェントは通常の作業でこれらを生成してはいけません。

入力 (例: リリーススクリプトから):

{
  "type": "chore",
  "scope": "release",
  "description": "v0.8.0"
}

出力:

chore(release): v0.8.0

🤖 Generated with [Codex](https://Codex.com/Codex)

Co-Authored-By: Codex <noreply@anthropic.com>

検証

• すべての規約に基づいたコミットタイプを正しくフォーマット
• オプションのスコープを適切に処理
• 長い説明と本文をラップ
• Codex の帰属表記を含む
• 破壊的な変更を正しくフォーマット
• 入力フィールドを検証

サポートファイル

• template.md: コミットメッセージテンプレート参照 (サポートファイルセクションを参照)
• docs/COMMIT_CONVENTIONS.md: プロジェクト規約全体と Release Please ルール