@himenon/claude-commit-msg-gen 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 K.Himeno
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# claude-commit-msg-gen
+
+[Claude API](https://www.anthropic.com/) と [Lefthook](https://lefthook.dev/) を組み合わせ、`git commit` 時に Conventional Commits 形式のコミットメッセージを自動生成するツールです。
+
+構造・設計の詳細は [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) を参照してください。
+
+## セットアップ
+
+### 1. Anthropic API キーを設定
+
+```sh
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+### 2. Lefthook をインストール
+
+```sh
+brew install lefthook
+pnpm add -g lefthook
+```
+
+### 3. バイナリをインストール
+
+```sh
+pnpm install -g @himenon/claude-commit-msg-gen
+```
+
+### 4. フックを有効化
+
+```sh
+lefthook install
+```
+
+以上で `git commit` 時にコミットメッセージが自動生成されます。
+
+## API キーをシェル環境に書きたくない場合
+
+`lefthook-local.yml` に API キーを記述する方法があります。このファイルは `.gitignore` 対象のため、リポジトリに混入しません。
+
+```yaml
+# lefthook-local.yml（.gitignore 対象）
+prepare-commit-msg:
+  jobs:
+    - name: auto-commit-message
+      env:
+        ANTHROPIC_API_KEY: "sk-ant-..."
+```
+
+`lefthook-local.yml` は `lefthook.yml` の設定を上書き・マージします。記述した `env` のみが上書きされ、他の設定は `lefthook.yml` の値が引き続き使われます。
+
+## トラブルシューティング
+
+**`Binary not found` と表示される**
+
+```sh
+pnpm run build
+```
+
+**`ANTHROPIC_API_KEY が未設定` と表示される**
+
+```sh
+echo $ANTHROPIC_API_KEY
+```
+
+**自動生成を一時的に無効にしたい**
+
+```sh
+LEFTHOOK=0 git commit
+```
+
+> `claude` CLI を使ったシェルスクリプトによる代替実装は [docs/shell-script-alternative.md](docs/shell-script-alternative.md) を参照してください。

package/bin/claude-commit-msg-gen

@@ -0,0 +1,14 @@
+#!/bin/sh
+OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
+ARCH="$(uname -m)"
+case "$ARCH" in
+  arm64|aarch64) ARCH="arm64" ;;
+  x86_64|amd64)  ARCH="amd64" ;;
+esac
+DIR="$(cd "$(dirname "$0")" && pwd)"
+BINARY="$DIR/claude-commit-msg-gen-${OS}-${ARCH}"
+if [ ! -x "$BINARY" ]; then
+  echo "[claude-commit-msg-gen] Binary not found: $BINARY" >&2
+  exit 0
+fi
+exec "$BINARY" "$@"

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@himenon/claude-commit-msg-gen",
+  "version": "0.1.0",
+  "description": "Claude API を使って git diff から Conventional Commits 形式のコミットメッセージを自動生成する CLI ツール",
+  "license": "MIT",
+  "author": "K.Himeno",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Himenon/claude-commit-msg-gen.git"
+  },
+  "bin": {
+    "claude-commit-msg-gen": "bin/claude-commit-msg-gen"
+  },
+  "files": [
+    "bin/",
+    "scripts/commit-prompt.txt"
+  ],
+  "devDependencies": {
+    "oxfmt": "^0.36.0"
+  },
+  "engines": {
+    "node": ">= 24.13.0"
+  },
+  "scripts": {
+    "build": "bash scripts/build.sh",
+    "format": "oxfmt",
+    "release:npm:registry": "pnpm publish --access public --no-git-checks",
+    "release:github:registry": "pnpm publish --access public --no-git-checks"
+  }
+}

package/scripts/commit-prompt.txt

@@ -0,0 +1,26 @@
+以下のgit diffを分析し、Conventional Commits形式のコミットメッセージを1行だけ生成してください。
+
+形式: type(scope): subject
+
+typeの選択基準:
+- feat: 新機能の追加
+- fix: バグ修正
+- docs: ドキュメントのみの変更
+- style: コードの動作に影響しない変更（フォーマット、空白など）
+- refactor: バグ修正でも機能追加でもないコード変更
+- test: テストの追加・修正
+- chore: ビルドプロセスや補助ツールの変更
+- ci: CI設定ファイルやスクリプトの変更
+- perf: パフォーマンス改善
+
+ルール:
+- subjectは日本語で記述すること
+- subjectは50文字以内にすること
+- 末尾に句読点を付けないこと
+- scopeは変更対象のモジュールやファイル名（省略可）
+- コミットメッセージの1行のみを出力すること。説明文や前後の文章は不要
+
+文章ルール:
+- 「データ」「正しい」「通常」「異常」「大量」「少量」などの抽象的表現を使わないこと。変更対象・処理内容・状態を具体的な技術用語で表現すること
+- 主語を具体的に書くこと。「これ」「それ」「あれ」などの指示詞を使わないこと
+- 「大きい」「小さい」「多い」「少ない」のような比較表現を使う場合は比較対象を明示すること（例: 「リクエスト数が毎秒100件を超える場合」）