git について
安全で再現可能な Git 操作を支援するスキルです。読み取り専用の確認、ブランチ、コミット、ワークツリー、タグ、PR の各手順に振り分けます。不可逆な操作の前に明示的な確認を求めます。
主な機能
- 01依頼に応じた Git 手順の選択
- 02状態、差分、CLI ヘルプの確認
- 03ブランチとワークツリーの管理
- 04コミット、タグ、PR の処理
- 05履歴変更時の確認必須化
- 06ワークツリーの整理ルール
活用シーン
- 01ファイルを変更せずリポジトリの状態や差分を確認
- 02手順に沿ったブランチ作成やワークツリー整理
- 03確認後に変更をステージしてコミット
- 04PR、タグ、履歴復旧操作の処理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bntvllnt/ agent-skills --skill gitインストール後、Claude Code で/gitを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdreferences/advanced-workflows.mdbranch-workflow.mdcli-help.mdcommit-workflow.mdpr-review-workflow.mdpr-workflow.mdread-only.mdtag-workflow.mdworktree-maintenance.mdworktree-summary.mdworktree-workflow.md詳細
Git
安全性を重視した、明確で再現可能な Git ワークフローです。
ルーター
ユーザーの意図に合う最小限のワークフローを使用します。
| ユーザーの発言 | 読み込むリファレンス | 実行内容 |
|---|---|---|
| status / what changed(「worktree」の接頭辞がない場合) | references/read-only.md | 読み取り専用の調査 |
| help / usage / man | references/cli-help.md | 安全に CLI ヘルプを表示 |
| commit / stage | references/commit-workflow.md | 安全にステージングしてコミット |
| branch / switch | references/branch-workflow.md | ブランチ操作 |
| worktree create/remove/list | references/worktree-workflow.md | worktree 操作 |
| worktree cleanup / normalize / consolidate | references/worktree-maintenance.md | worktree を自動クリーンアップして統合 |
| worktree summary / worktree status / show worktrees | references/worktree-summary.md | 先回りした分析:PR の状況、変更の分類、安全に削除できるかの判断 |
| tag / version | references/tag-workflow.md | タグの作成/一覧表示/確認 |
| pr / pull request | references/pr-workflow.md | gh を使用した PR の作成/更新 |
| pr review / fix pr comments / threads | references/pr-review-workflow.md | レビュー、返信、修正 |
| merge / rebase / reset / revert | references/advanced-workflows.md | 高度な操作/復旧(最初に確認) |
設定(ここで編集)
worktree の作業ディレクトリ(cd するフォルダー)は .git/ の外に置きます。
次の値を一度設定し、すべての場所で使用します。
WORKTREES_DIR=./.worktrees
WORKTREE_PATH=$WORKTREES_DIR/<topic>
別の場所(例:../.worktrees や ~/worktrees/<repo>)を使う場合は、上記の WORKTREES_DIR を更新し、references/worktree-workflow.md でも同じ形式にしてください。
復旧性のルール(Worktree)
- worktree のルートフォルダーが複数検出された場合(例:
./.worktrees/と../repo-feature-x/の両方が存在する場合)、デフォルトでは何も削除しないでください。 - 可能であれば
git worktree moveを使ってWORKTREES_DIRに統合することを優先します。難しい場合は、削除して再追加する計画を立ててください。 - 古いメタデータがある場合は、クリーンアップ計画として
git worktree pruneと、孤立したディレクトリの削除/隔離を提案してください(要確認)。
全般的な安全ルール(必ず守ること)
- main/master への強制プッシュは決して行わないでください。
- シークレット(env ファイル、鍵、認証情報)は決してコミットしないでください。
- 明示的に依頼されない限り、すでにプッシュ済みの履歴を書き換えないでください。
- 取り消し不能な操作の前には、必ず変更内容を提示してください。
確認ポリシー
読み取り専用のコマンドは常に実行できます。
状態/履歴/リモートに変更を加える操作には、すべてユーザーの明示的な確認が必要です。
git add、git commit、git pushgit merge、git rebase、git reset、git revertgit worktree add、git worktree removegit tag(作成/削除)git branch -d/-D
クイックスタート
# Read-only
git status
git diff
# Commit
git diff --cached
git commit -m "feat(scope): why"
# Worktrees
git worktree list
コメント
Markdown 対応