
shiiman-git
Git ローカル操作 - ステージング・コミット、worktree 管理・セットアップを提供
- version
- 5.0.0
- GitHub stars
- 7
Install
/plugin install shiiman-git@shiiman-claude-code-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.
Contents
Discovered from sourceSkills 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.db | OS システムファイル |
*.log, *.tmp | ログ・一時ファイル |
dist/, build/, coverage/ | ビルド成果物 |
IDE 設定ファイル(検出時は警告 + .gitignore 追加を提案):
| パターン | 説明 |
|---|---|
.idea/ | JetBrains |
.vscode/ | VS Code |
*.swp, *.swo | Vim |
検出時の対応:
- 秘密情報、無関係なユーザーの変更、意図しない生成物はステージしない。秘密情報を出力せずに内容を確認し、ファイル名だけで認証情報の有無を判断しない。
- 許可されたパスや 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 ライフサイクルで自動実行するコマンドを定義する。
| フック名 | 説明 | 例 |
|---|---|---|
postCreate | worktree 作成後 | npm install |
preRemove | worktree 削除前(失敗時中断) | npm run clean |
postRemove | worktree 削除後 | echo "removed" |
[defaults] セクション
デフォルトのエディタと AI ツールを定義する。
| 設定項目 | 説明 | 例 |
|---|---|---|
editor | デフォルトエディタ | cursor, code, vim |
ai | デフォルト AI ツール | claude, other |
重要な注意事項
- ✅ 何度実行しても安全(冪等)
- ✅ 既存設定がある場合は差分を提示して確認
- ✅ バックアップを自動作成
- ❌ ユーザーの確認なしに既存設定を上書きしない
関連リソース
- gtr 公式リポジトリ: https://github.com/coderabbitai/git-worktree-runner
- 関連スキル:
worktree- gtr で worktree を管理
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
処理フロー:
- ブランチ名を確認(指定がない場合はユーザーに質問)
git gtr new <branch> --from-currentを実行- 成功メッセージを表示
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
処理フロー:
- 削除対象のブランチ名を確認(
git gtr listで一覧を提示) - ユーザー確認後に
--delete-branch付きで削除実行 - 成功メッセージを表示
クリーンアップ
トリガー: 「クリーンアップ」「マージ済み削除」「不要な worktree を整理」
不要な worktree を一括削除する。
git gtr clean
処理フロー:
- まず
git gtr clean --dry-runでプレビューを表示 - ユーザー確認後に
git gtr cleanを実行 - 成功メッセージを表示
エラーハンドリング
gtr がインストールされていない場合
gtr がインストールされていません。
`/shiiman-git:worktree-setup` でインストールと設定ができます。
worktree 削除時に未コミット変更がある場合
警告を表示し、--force オプションの使用を提案する。
関連リソース
- gtr 公式リポジトリ: https://github.com/coderabbitai/git-worktree-runner
- 関連スキル:
worktree-setup- gtr のインストールと .gtrconfig 設定
Sponsors
Details
- Marketplace
- shiiman/claude-code-plugins
- Source
- plugins/shiiman-git
- Category
- Developer Tools