By name: ok-git description: git config global を前提に、日常的な Git 操作（状況確認・ブランチ作成・安全コミット・同期）を bundled script で実行する。ユーザーが「コミットして」「ブランチ切って」「pushして」「差分見て」などを依頼したときに使う。作業リポジトリ直下の scripts/ は前提にせず、agent skills ディレクトリ内の ok-git/scripts/git_ops.sh を解決して使う。git config は変更せず既存設定を利用する。 compatibility: codex,copilot
OK Git
目的
Git 日常作業を安全に高速化する。
この skill は git config を変更せず、既存の global 設定を使って操作する。
トリガー例
- 「この変更をコミットして push して」
- 「作業ブランチ切って進めて」
- 「今の状態と差分を見て」
- 「rebase pull して同期して」
絶対ルール
git config --global/--local/--systemを変更しない。git commit --authorを使わない。- コミットメッセージに
Co-Authored-Byを入れない。 - 破壊的操作（
reset --hard、履歴改変 push など）はユーザー明示指示がない限り行わない。 - ブランチ名はリポジトリごとの既存慣習を優先する。
codex/などの prefix を勝手に固定しない。
Agent Execution Contract
- この skill の
scripts/git_ops.shは、作業リポジトリ直下ではなく skill bundle 内にある。 scripts/git_ops.shを現在の project から相対参照してはいけない。- まず agent 側の skills ディレクトリから
ok-git/scripts/git_ops.shを解決し、その絶対パスを使って実行する。 - 候補パスは次の順に確認する:
~/.codex/skills/ok-git/scripts/git_ops.sh~/.copilot/skills/ok-git/scripts/git_ops.sh
- helper script が見つからない場合は「skill 配置が壊れている」と報告して停止する。勝手に生の
git/ghコマンド列へ置き換えない。 - helper script の実行時だけ script の絶対パスを使い、Git 操作の対象リポジトリは常にユーザーの現在の作業ディレクトリとする。
helper script の解決例:
for root in "$HOME/.codex/skills" "$HOME/.copilot/skills"; do
if [ -x "$root/ok-git/scripts/git_ops.sh" ]; then
OK_GIT_SCRIPT="$root/ok-git/scripts/git_ops.sh"
break
fi
done
if [ -z "${OK_GIT_SCRIPT:-}" ]; then
echo "[ERROR] ok-git helper script was not found in agent skills directories" >&2
exit 1
fi
標準フロー
1. 状態確認
"$OK_GIT_SCRIPT" inspect
以下を確認する:
- 現在ブランチ
- 変更状況（
git status -sb） - remote
- global / effective の
user.name,user.email
2. ブランチ作成（必要時）
"$OK_GIT_SCRIPT" start-branch --name <branch-name> --base main
- ブランチ名を決める前に、既存のローカル/リモートブランチ名、直近のマージ済みブランチ、必要なら PR タイトルや issue 番号を見て、そのリポジトリの命名慣習に合わせる。
- 明示指示や既存慣習がない場合でも、エージェント都合の固定 prefix は付けない。
- 既存ブランチ名との衝突を検出して停止する。
--baseを省略すると現在ブランチから作成する。
3. 安全コミット
全変更をまとめてコミット:
"$OK_GIT_SCRIPT" commit --all --message "<日本語メッセージ>"
対象ファイルだけコミット:
"$OK_GIT_SCRIPT" commit --paths "path/a,path/b" --message "<日本語メッセージ>"
ルール:
- コミット時は global
user.name/user.emailを明示的に使用する。 Co-Authored-Byを含むメッセージは拒否する。
4. 同期（pull/push）
rebase pull:
"$OK_GIT_SCRIPT" sync
rebase pull + push:
"$OK_GIT_SCRIPT" sync --push
sync --pushは、既存 upstream があるブランチでは rebase pull の後に push する。- 初回 push で upstream 未設定かつリモートブランチ未作成の場合は、helper が
git push -u相当へ自動フォールバックする。 sync単体は初回 push を自動で作らない。未設定ブランチで pull 先がない場合は停止する。
失敗時の対処
- コンフリクト時は自動解決しない。競合ファイルを提示してユーザー確認後に進める。
- global identity が未設定の場合は停止し、設定状況を報告する（設定変更は行わない）。
- helper script が見つからない場合は、skill インストール/同期不備として報告する。作業リポジトリ直下の
scripts/を探し続けない。
実装補助
- 統合スクリプト:
ok-git/scripts/git_ops.sh