Git ローカル操作 - ステージング・コミット、worktree 管理・セットアップを提供

version
5.0.0
GitHub stars
7

Install

/plugin install shiiman-git@shiiman-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.

Contents

Discovered from source

Skills 3

Add & Commit

セキュリティチェック → コミットメッセージ生成 → ステージング → コミットを行うスキル。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-git:add-commit - Add & Commit

概要:
  セキュリティチェック + .gitignore チェックを実行し、
  変更をステージング・コミットする。

使用方法:
  /shiiman-git:add-commit [オプション]

オプション:
  --help        このヘルプを表示
  --no-confirm  許可済みワークフローからの呼び出し用の互換オプション

許可と確認の方針

グローバルの許可方針と現在の依頼から実行範囲を判断する。このスキルの操作を明示的に依頼されていれば、それを許可として扱い、生成した文面の承認や --no-confirm の指定を改めて求めない。このオプションは許可済みの呼び出しとの互換用であり、指定自体が許可を与えるものではない。セキュリティチェックは維持し、許可不足、重要な範囲変更、許可範囲外の具体的なリスクがある場合だけ確認する。

ワークフロー

1. 変更内容の確認

git status
git diff
git diff --staged

2. セキュリティチェック + .gitignore チェック

変更対象のファイルを以下のカテゴリでチェックする。

機密ファイル(検出時はコミットをブロック):

パターン説明
.env*環境変数ファイル
*.pem, *.key秘密鍵
credentials.json認証情報
*_secret*, *_token*シークレット
.aws/, .gcp/クラウド認証情報

一般的な無視対象(検出時は警告 + .gitignore 追加を提案):

パターン説明
node_modules/Node.js 依存パッケージ
vendor/PHP/Go 依存パッケージ
.DS_Store, Thumbs.dbOS システムファイル
*.log, *.tmpログ・一時ファイル
dist/, build/, coverage/ビルド成果物

IDE 設定ファイル(検出時は警告 + .gitignore 追加を提案):

パターン説明
.idea/JetBrains
.vscode/VS Code
*.swp, *.swoVim

検出時の対応:

  • 秘密情報、無関係なユーザーの変更、意図しない生成物はステージしない。秘密情報を出力せずに内容を確認し、ファイル名だけで認証情報の有無を判断しない。
  • 許可されたパスや hunk だけをステージする。ユーザーの index と作業ツリーを保護し、既存のステージ済み変更を自動で reset しない。
  • タスクで生成した明らかな成果物は、必要に応じて .gitignore に追加する。IDE 設定や vendor の扱いが曖昧な場合はリポジトリの慣例に従い、無関係なファイルは変更しない。除外内容は報告し、パターンごとの承認は求めない。
  • コミット予定の内容に秘密情報が含まれる場合は、その内容のコミットを止め、安全に解消してから続行する。

3. コミットメッセージ生成

変更内容を分析し、Conventional Commits 形式でメッセージを自動生成する。

プレフィックス判定:

変更内容プレフィックス
新規ファイル追加(機能)feat:
バグ修正fix:
ドキュメント変更docs:
リファクタリングrefactor:
テスト追加・修正test:
ビルド・依存関係chore:

4. コミット許可の確認

対象変更のコミットが依頼済みなら、検証後に再確認せず進める。許可がない場合は、対象の差分とコミットメッセージを用意してから許可を求める。--no-confirm でもセキュリティチェックは省略せず、無関係な変更のコミットは許可されない。

5. ステージング

git add {対象ファイル}

6. コミット

コミット直前に実際の対象内容を確認する。下記のコマンドは、index に許可された変更だけが含まれる場合に使う。無関係な変更が既にステージされている場合は、一時 index など対象を限定できる方法を使い、ユーザーのステージ済み・未ステージの作業を保持する。無関係な変更を黙って含めたり reset したりしない。

git commit -m "{コミットメッセージ}"

7. 許可されている場合の push

コミットだけの依頼では push しない。push または PR 作成が明示的に依頼されている場合は、remote・branch・送信対象のコミットを確認し、必要な通常の push を実行する。新規 feature branch では git push -u origin {branch_name} を使う。必要な許可なしに force-push、デフォルトブランチへの push、無関係な作業の公開、リポジトリのチェック回避は行わない。push の依頼がなければ、追加の選択を質問せずコミット結果を報告して終了する。

重要な注意事項

  • 既存のコミット許可を再利用し、同じ内容の承認を取り直さない。
  • ✅ 機密ファイルを検出した場合はコミットをブロック(--no-confirm でも実行)
  • ✅ Conventional Commits 形式を使用
  • 許可された範囲外の変更をコミットしない。
  • push の依頼、または明示的な PR 作成依頼に必要な場合だけ push する。
  • ❌ デフォルトブランチへの直接コミットは避ける(警告を出す)

Worktree Setup

gtr (git-worktree-runner) のインストール確認と .gtrconfig の生成・更新を行うスキル。 実行するたびにプロジェクトの現状に合わせて .gtrconfig を更新する。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-git:worktree-setup - Worktree Setup

概要:
  gtr のインストール確認と .gtrconfig の生成・更新を行う。
  実行するたびにプロジェクトの現状に合わせて .gtrconfig を更新する。

使用方法:
  /shiiman-git:worktree-setup [オプション]

オプション:
  --help  このヘルプを表示

実行フロー

ステップ 1: gtr インストール確認

git gtr --version

未インストール時の対応:

インストール手順を案内して処理を終了する。

gtr がインストールされていません。以下の手順でインストールしてください:

## インストール方法

# Homebrew(推奨)
brew install coderabbitai/gtr/git-gtr

# または手動インストール
git clone https://github.com/coderabbitai/git-worktree-runner.git
cd git-worktree-runner
sudo ln -s "$(pwd)/bin/git-gtr" /usr/local/bin/git-gtr

# 確認
git gtr --version

ステップ 2: プロジェクト状態を分析

パッケージファイルからプロジェクトタイプを自動検出する。

# Node.js
[ -f "package.json" ] && PROJECT_TYPE="nodejs"

# Python
[ -f "pyproject.toml" ] || [ -f "requirements.txt" ] && PROJECT_TYPE="python"

# Go
[ -f "go.mod" ] && PROJECT_TYPE="go"

# Rust
[ -f "Cargo.toml" ] && PROJECT_TYPE="rust"

# PHP
[ -f "composer.json" ] && PROJECT_TYPE="php"

# その他
PROJECT_TYPE="generic"

既存の .gtrconfig があれば読み込む:

cat .gtrconfig 2>/dev/null

ステップ 3: .gtrconfig を生成/更新

プロジェクトタイプに応じたテンプレートをベースに生成する。 既存設定がある場合は差分を提示してユーザーに確認する。

Node.js プロジェクト
[copy]
  include = **/.env.example
  include = **/.nvmrc
  include = **/tsconfig.json
  include = **/.prettierrc
  include = **/.eslintrc*
  exclude = **/.env
  exclude = **/.env.local
  excludeDirs = node_modules
  excludeDirs = dist
  excludeDirs = .next
  excludeDirs = build

[hooks]
  postCreate = npm install

[defaults]
  editor = cursor
  ai = claude
Python プロジェクト
[copy]
  include = **/.env.example
  include = **/pyproject.toml
  include = **/requirements*.txt
  include = **/.python-version
  exclude = **/.env
  exclude = **/.env.local
  excludeDirs = .venv
  excludeDirs = venv
  excludeDirs = __pycache__
  excludeDirs = .mypy_cache
  excludeDirs = .pytest_cache
  excludeDirs = *.egg-info

[hooks]
  postCreate = pip install -e ".[dev]"

[defaults]
  editor = cursor
  ai = claude
Go プロジェクト
[copy]
  include = **/.env.example
  include = **/go.mod
  include = **/go.sum
  exclude = **/.env
  exclude = **/.env.local
  excludeDirs = vendor
  excludeDirs = bin

[hooks]
  postCreate = go mod download

[defaults]
  editor = cursor
  ai = claude
Rust プロジェクト
[copy]
  include = **/.env.example
  include = **/Cargo.toml
  include = **/Cargo.lock
  exclude = **/.env
  exclude = **/.env.local
  excludeDirs = target
  excludeDirs = .cargo

[hooks]
  postCreate = cargo fetch

[defaults]
  editor = cursor
  ai = claude
PHP プロジェクト
[copy]
  include = **/.env.example
  include = **/composer.json
  include = **/composer.lock
  exclude = **/.env
  exclude = **/.env.local
  excludeDirs = vendor

[hooks]
  postCreate = composer install

[defaults]
  editor = cursor
  ai = claude
Generic プロジェクト
[copy]
  include = **/.env.example
  exclude = **/.env
  exclude = **/.env.local

[hooks]
  postCreate = echo "Worktree created successfully"

[defaults]
  editor = cursor
  ai = claude

ステップ 4: ファイル書き込み

初回の場合はそのまま生成する。 既存ファイルがある場合はバックアップを作成し、差分を表示してユーザー確認後に更新する。

# バックアップ(既存ファイルがある場合)
[ -f .gtrconfig ] && cp .gtrconfig .gtrconfig.backup

ステップ 5: 完了報告

## .gtrconfig を更新しました

プロジェクトタイプ: {PROJECT_TYPE}

{変更内容の差分 or 生成された内容}

### 次のステップ

- worktree を作成: `/shiiman-git:worktree`

.gtrconfig 設定項目の詳細

[copy] セクション

worktree 作成時にコピーするファイルのルールを定義する。

設定項目説明例
includeコピーする glob パターン**/.env.example
exclude除外する glob パターン**/.env
includeDirsコピーするディレクトリnode_modules
excludeDirs除外するディレクトリnode_modules/.cache

[hooks] セクション

worktree ライフサイクルで自動実行するコマンドを定義する。

フック名説明例
postCreateworktree 作成後npm install
preRemoveworktree 削除前(失敗時中断)npm run clean
postRemoveworktree 削除後echo "removed"

[defaults] セクション

デフォルトのエディタと AI ツールを定義する。

設定項目説明例
editorデフォルトエディタcursor, code, vim
aiデフォルト AI ツールclaude, other

重要な注意事項

  • ✅ 何度実行しても安全(冪等)
  • ✅ 既存設定がある場合は差分を提示して確認
  • ✅ バックアップを自動作成
  • ❌ ユーザーの確認なしに既存設定を上書きしない

関連リソース

Worktree Management with gtr

gtr (git-worktree-runner) を使用して git worktree を管理するスキル。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-git:worktree - Worktree Management with gtr

概要:
  gtr を使用して worktree の作成・一覧・削除・クリーンアップを行う。

使用方法:
  /shiiman-git:worktree [オプション]

オプション:
  --help  このヘルプを表示

対応コマンド:
  new     現在のブランチから worktree を作成
  list    worktree の一覧を表示
  rm      worktree をブランチごと削除
  clean   不要な worktree をクリーンアップ

前提条件

  • gtr (git-worktree-runner) がインストール済み
    • 未インストールの場合は git-worktree-setup スキルを案内する

機能

ユーザーの発話内容から以下の 3 パターンを判定して実行する。

1. worktree 作成

トリガー: 「worktree 作成」「gtr new」「新しい worktree」「ワークツリー作成」

現在のブランチをベースに worktree を作成する。

git gtr new <branch> --from-current

処理フロー:

  1. ブランチ名を確認(指定がない場合はユーザーに質問)
  2. git gtr new <branch> --from-current を実行
  3. 成功メッセージを表示

2. worktree 一覧

トリガー: 「worktree 一覧」「gtr list」「ワークツリー一覧」「worktree 確認」

git gtr list

結果をテーブル形式に整形して表示:

## Worktree 一覧

| ブランチ | パス |
|----------|------|
| main | /path/to/main |
| feature/A | /path/to/feature-A |

3. worktree 削除 + クリーンアップ

個別削除

トリガー: 「worktree 削除」「gtr rm」「ワークツリー削除」「worktree を消す」

ブランチごと複数 worktree をまとめて削除する。

git gtr rm <branch1> <branch2> --delete-branch

処理フロー:

  1. 削除対象のブランチ名を確認(git gtr list で一覧を提示)
  2. ユーザー確認後に --delete-branch 付きで削除実行
  3. 成功メッセージを表示
クリーンアップ

トリガー: 「クリーンアップ」「マージ済み削除」「不要な worktree を整理」

不要な worktree を一括削除する。

git gtr clean

処理フロー:

  1. まず git gtr clean --dry-run でプレビューを表示
  2. ユーザー確認後に git gtr clean を実行
  3. 成功メッセージを表示

エラーハンドリング

gtr がインストールされていない場合

gtr がインストールされていません。
`/shiiman-git:worktree-setup` でインストールと設定ができます。

worktree 削除時に未コミット変更がある場合

警告を表示し、--force オプションの使用を提案する。

関連リソース

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-git
Category
Developer Tools

More from shiiman/claude-code-plugins

All 9