commit-convention
Gitのコミットメッセージを、プロジェクトの既存スタイルに合わせ、なければConventional Commitsというルールに従って、読みやすく統一された形式で記述するSkill。
📜 元の英語説明(参考)
Git 提交信息规范。着重于提交信息的格式化、风格统一。优先学习并沿用项目已有的提交历史风格,若无明显风格或为新项目,则遵循 Conventional Commits 规范。
🇯🇵 日本人クリエイター向け解説
Gitのコミットメッセージを、プロジェクトの既存スタイルに合わせ、なければConventional Commitsというルールに従って、読みやすく統一された形式で記述するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o commit-convention.zip https://jpskill.com/download/8767.zip && unzip -o commit-convention.zip && rm commit-convention.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8767.zip -OutFile "$d\commit-convention.zip"; Expand-Archive "$d\commit-convention.zip" -DestinationPath $d -Force; ri "$d\commit-convention.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
commit-convention.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
commit-conventionフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Commit Convention
この Skill は、git commit や git add 操作を直接実行するのではなく、現在の Agent にコミット情報の意思決定の指導とフォーマット標準を提供します。
核心戦略
1. スタイル学習(優先)
コミット情報を生成する前に、プロジェクトの既存のコミット習慣を観察する必要があります。
git log -n 5 --onelineを実行します。- 履歴とのマッチング: プロジェクトが特定の前置詞(
[FEAT]、Update:など)や言語習慣を使用している場合は、優先的に模倣し、一貫性を保つ必要があります。 - 言語の一貫性: 履歴がすべて中国語の場合は、中国語で記述します。すべて英語の場合は、英語を使用します。
2. 規範へのフォールバック(Fallback)
プロジェクトのコミット履歴が空、明確なパターンがない場合、またはプロジェクトが標準化されたコミットを使用することを明確に要求している場合は、Conventional Commits 規約に従ってください。
<type>(<scope>): <subject>
<body>
<footer>
Type タイプの定義
feat: 新機能fix: バグ修正docs: ドキュメントの変更style: コードの意味に影響を与えない変更(空白、フォーマット、セミコロンの欠落など)refactor: リファクタリング(バグ修正でも機能追加でもないコードの変更)perf: パフォーマンスの改善test: 欠落しているテストの追加または既存のテストの修正build: ビルドシステムまたは外部依存関係に影響を与える変更ci: CI 構成ファイルとスクリプトの変更chore: その他の src またはテストファイルを変更しない変更revert: 以前のコミットのロールバック
Subject のフォーマット
- 命令形を使用します("added" ではなく "add" など)。
- 末尾にピリオドを付けません。
- 先頭の文字は小文字にします(固有名詞を除く)。
- 長さは 50 文字以内に制御します。
操作指令 (Agent のみの参考)
Agent がコミット情報を生成する必要がある場合は、次のロジックに従って検討する必要があります。
- 観察:
git log -n 5 --onelineを使用して、プロジェクトのスタイルを観察します。 - 判断:
- 既定のパターンを発見しましたか? → そのパターンを模倣します。
- Conventional Commits パターンを発見しましたか? → この規約に従います。
- 最初のコミット/パターンなし? → Conventional Commits を採用します。
- 作成:
- 簡潔な Subject。
- 必要に応じて Body を提供します(How ではなく Why を説明します)。
- Issue を関連付けます(
Closes #123など)。
注意事項
- 過度な設計の禁止: 変更が本当に複雑でない限り、複雑すぎるコミット情報を生成しないでください。
- 原子性: 1 つのコミットで 1 つのことだけを行うことをお勧めします。変更が多すぎる場合は、ユーザーにコミットを分割するように促すことをお勧めします。
- コマンドの実行禁止: この Skill は「情報提供」のみを行い、操作の実行はメイン Agent が決定します。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Commit Convention
该 Skill 不直接执行 git commit 或 git add 操作,而是为当前 Agent 提供提交信息的决策指导和格式标准。
核心策略
1. 风格学习(优先)
在生成提交信息前,必须先观察项目已有的提交习惯:
- 执行
git log -n 5 --oneline。 - 匹配历史:如果项目习惯使用特定的前缀(如
[FEAT]、Update:等)或语言习惯,应优先模仿并保持一致。 - 语言一致性:如果历史记录全是中文,则使用中文描述;如果全是英文,则使用英文。
2. 规范回退(Fallback)
如果项目提交记录为空、无明显规律,或项目明确要求使用规范化提交,请遵循 Conventional Commits 规范:
<type>(<scope>): <subject>
<body>
<footer>
Type 类型定义
feat: 新功能fix: 修补 bugdocs: 文档变更style: 不影响代码含义的变更(空白、格式、缺少分号等)refactor: 重构(既不是修复 bug 也不是添加特征的代码更改)perf: 改进性能test: 添加缺失测试或更正现有测试build: 影响构建系统或外部依赖项的更改ci: 更改 CI 配置文件和脚本chore: 其他不修改 src 或测试文件的更改revert: 回退之前的提交
Subject 格式
- 使用祈使句(如 "add" 而不是 "added")。
- 结尾不加句号。
- 首字母小写(除非是专有名词)。
- 长度控制在 50 字符以内。
操作指令 (仅供 Agent 参考)
当 Agent 需要生成提交信息时,应按以下逻辑思考:
- 观察:使用
git log -n 5 --oneline观察项目风格。 - 判断:
- 发现既定规律?→ 模仿该规律。
- 发现 Conventional Commits 模式?→ 遵循本规范。
- 初始提交/无规律?→ 采用 Conventional Commits。
- 撰写:
- 简洁的 Subject。
- 必要时提供 Body(解释 Why 而不是 How)。
- 关联 Issue(如
Closes #123)。
注意事项
- 严禁过度设计:不要生成过于复杂的提交信息,除非变更确实复杂。
- 原子性:建议一个提交只做一件事。如果发现变更过多,建议提示用户拆分提交。
- 禁止执行命令:本 Skill 仅提供“信息建议”,执行操作由主 Agent 决定。