checkpoint について
checkpointは、ローカルのGitチェックポイントコミットを作成する開発スキルです。変更を確認し、lint・型チェック・ビルドの成功後に、リポジトリの規約に沿って変更をステージングしてコミットします。
主な機能
- 01Gitの状態、差分、直近のコミットを確認
- 02lint・型チェック・ビルドを実行
- 03コミット前にすべての変更をステージング
- 04規約に沿ったコミット文と共著者署名を作成
- 05コミットと変更の統計を報告
活用シーン
- 01コード変更のチェックポイントを作成
- 02コミット前にプロジェクトのチェックを検証
- 03リポジトリの規約に沿ってコミットを準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ leonvanzyl/ agentic-coding-starter-kit --skill checkpointインストール後、Claude Code で/checkpointを入力して読み込まれたか確認します。
詳細
チェックポイントコミット
現在のすべての変更を含むチェックポイントコミットを作成します。ただし、コードが lint、型チェック、ビルドに合格した後に限ります。
手順
ステップ 1: 変更を分析する
次のコマンドを実行して、全体像を把握します。
git status— 追跡対象ファイルと未追跡ファイルをすべて確認しますgit diff— 追跡対象ファイルの詳細な変更を確認しますgit diff --cached— すでにステージングされた変更を確認しますgit log -5 --oneline— このリポジトリのコミットメッセージのスタイルを把握します
ステップ 2: 品質チェック
3 つすべてのチェックを実行します。失敗したものがあれば、先に問題を修正してください。失敗をスキップしたり無視したりしないでください。
npm run lint— lint エラーを修正しますnpm run type-check— 型エラーを修正します(スクリプトが存在しない場合は、npx tsc --noEmitを試します)npm run build— ビルドエラーを修正します
3 つすべてが問題なく通るまで繰り返します。その後でのみ、次のステップに進んでください。
ステップ 3: すべてをステージングする
追跡対象の変更、削除、新しい未追跡ファイルを含め、すべての変更をステージングします。
git add -A
ステップ 4: コミットメッセージを作成する
git log で確認したプロジェクトの既存の規約に従ってコミットメッセージを作成します。構成は次のとおりです。
- 1 行目:命令形で、明確かつ簡潔な概要(50~72 文字)
- プロジェクトで使用されている場合は、
feat:、fix:、refactor:、docs:、chore:などの Conventional Commits のプレフィックスを使用します。
- プロジェクトで使用されている場合は、
- 本文(空行で区切る):変更内容を簡潔にまとめます。最大 1~3 文です。箇条書き、ファイルごとの説明、長い解説は含めないでください。
- フッター:共同作成者の帰属情報
ステップ 5: コミットする
適切な書式を保つため、ヒアドキュメントを使ってコミットを作成します。
git commit -m "$(cat <<'EOF'
{first line}
{tldr}
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
EOF
)"
ステップ 6: 報告する
次の内容を表示します。
- コミットハッシュとメッセージの概要
- 変更したファイル数
- 追加・削除の概要
重要
.envや認証情報など、明らかに機密情報である場合を除き、すべてをステージングしてコミットしてください。ファイルをスキップしないでください。- リポジトリに Git の履歴がない場合は、先に
git initを実行してください。 - コミット前に、すべての品質チェック(lint、型チェック、ビルド)に必ず合格してください。問題を修正し、スキップしないでください。
- コミット本文は短くしてください。長い説明ではなく、簡潔な要約にします。
- プロジェクトの既存のコミット規約に従ってください(先にログを確認してください)。
- push はしないでください。ローカルでコミットするだけにしてください。
コメント
Markdown 対応