OpenClaw Conventional Commits スキルガイド

OpenClaw Conventional Commits スキル概要

Conventional Commits スキルは、構造化された仕様準拠のコミットメッセージをOpenClawワークフローに導入します。コミットメッセージをゼロから書いたり、Conventional Commits 仕様を覚えたりする代わりに、OpenClawエージェントにステージされた変更に基づいてメッセージの生成や検証を依頼するだけです。

Conventional Commitsは、コミットメッセージの上に構築された軽量な規約で、明確で機械可読な履歴を提供します。自動変更履歴、セマンティックバージョニング、リリースツールを何千ものオープンソースおよびエンタープライズプロジェクトで支えています。このOpenClawスキルを使えば、認知的負荷なしにこれらの利点を享受できます。

典型的なワークフロー：

1. git add で変更をステージする。
2. OpenClawにコミットメッセージの作成を依頼する。
3. エージェントが差分を分析し、正しいタイプ（feat、fix、docs など）を判断し、適切にフォーマットされたメッセージを提案します。

Conventional Commits スキルの前提条件

Conventional Commits スキルをインストールする前に、以下を確認してください：

• OpenClaw がインストールされ実行中（v1.0+）
• Git がインストール済み（v2.20+）— 公式ダウンロード
• git init で初期化されたプロジェクトリポジトリ
• clawhub CLI がインストール済み

環境を確認：

# OpenClaw バージョンを確認
openclaw --version

# Git バージョンを確認
git --version

# Git リポジトリ内にいることを確認
git status

Conventional Commits スキルのインストール方法

1つのコマンドでConventional Commitsスキルをインストール：

npx clawhub@latest install conventional-commits

インストールを確認：

clawhub list

インストール済みスキルリストに conventional-commits が表示されるはずです。このスキルはすぐに使えます — APIキーや外部サービスは不要です。

Conventional Commits スキルの設定

このスキルは最小限の設定で動作します。ステージされたGit変更を読み取り、Conventional Commits仕様に従ってメッセージをフォーマットします。ただし、チームの規約に合わせて動作をカスタマイズできます。

コミットタイプ

スキルは標準的なConventional Commitsタイプを認識します：

| タイプ | 使用場面 | |--------|---------| | feat | ユーザー向けの新機能 | | fix | バグ修正 | | docs | ドキュメントのみの変更 | | style | フォーマット、セミコロンの欠落（ロジック変更なし） | | refactor | 機能やバグ修正を伴わないコード再構築 | | perf | パフォーマンス改善 | | test | テストの追加・更新 | | chore | ビルドプロセス、依存関係の更新、ツール設定 | | ci | CI/CD設定の変更 |

スコープ付きコミット

モノレポや大規模プロジェクト向けのスコープ付きコミットメッセージをサポート：

feat(auth): add OAuth2 login flow
fix(api): handle null response from payment endpoint
docs(readme): update installation instructions

プロジェクト設定で許可するスコープを定義し、コントリビューター間の一貫性を保つことができます。

Conventional Commits スキルの使用例

1. ステージされた変更からコミットメッセージを生成

あなた：「ステージされた変更のコミットメッセージを書いて。」

エージェントは git diff --staged を確認し、新しいAPIエンドポイントを追加したことを識別して返します：

feat(api): add user profile endpoint

Implement GET /api/users/:id/profile with authentication
middleware and response caching.

承認、編集、または異なるトーンやスコープで再生成を依頼できます。

2. 既存のコミットメッセージを検証

あなた：「このコミットメッセージが規約に沿っているか確認して：'Updated the login page'」

エージェントはメッセージを分析し、具体的なフィードバックを返します：

• タイプ接頭辞が欠落 — feat:、fix: または他の有効なタイプで始める必要あり
• 過去形（"Updated"）を使用 — 規約では命令形（"update"）を推奨
• 修正案：fix(auth): update login page layout

3. 最近のコミットを一括検証

あなた：「このブランチの最新10件のコミットメッセージを検証して。」

エージェントは最近の履歴を確認し、規約に準拠していないコミットをフラグ付けし、それぞれに修正案を提供します。機能ブランチを main にマージする前に便利です。

4. 破壊的変更コミットを生成

あなた：「これを破壊的変更としてコミットして — v1 APIを削除した。」

エージェントは適切な破壊的変更コミットをフォーマット：

feat(api)!: remove deprecated v1 endpoints

BREAKING CHANGE: All /api/v1/* routes have been removed.
Consumers must migrate to /api/v2/* before upgrading.

! サフィックスと BREAKING CHANGE フッターの両方が含まれ、semantic-release や standard-version などのツールとの互換性を確保します。

セキュリティとベストプラクティス

Conventional Commitsスキルは、OpenClawエコシステムで最も安全なスキルの1つです — テキストのフォーマットと検証のみを行い、外部APIコールやローカルGitリポジトリ外への書き込み操作はありません。

最良の体験のために以下のガイドラインに従ってください：

• コミット前に確認。 生成されたメッセージを承認する前に必ず確認してください。エージェントは差分から意図を推測しますが、コンテキストを最もよく知っているのはあなたです。
• 一貫したスコープを使用。 プロジェクトの許可スコープリストを定義し、チームと共有してスコープの混乱を防ぎましょう。
• CI検証と組み合わせる。 commitlint などのツールでCIパイプラインにConventional Commitsを強制し、スキルをスキップした手動コミットをキャッチできます。
• プリコミットフックを有効にする。 husky や lefthook を使ってコミットメッセージ検証を自動実行しましょう。

よくあるエラーのトラブルシューティング

"Not a git repository"

このスキルはGit初期化されたディレクトリ内で実行する必要があります。

# 新しいリポジトリを初期化
git init

# または既存のプロジェクトに移動
cd /path/to/your/project

"No staged changes found"

意味のあるコミットメッセージを生成するには、ステージされた変更が必要です。

# 特定のファイルをステージ
git add src/feature.ts

# またはすべての変更をステージ
git add -A

"Unable to determine commit type"

差分が非常に大きい場合や、多くの無関係なファイルに変更がある場合に発生する可能性があります。より小さく焦点を絞った変更セットをステージするか、タイプを手動で指定してください：

あなた：「これらの変更のrefactorコミットメッセージを書いて。」