コミットフロー

ユーザーがコミットやステージングを依頼した際に、ドキュメント生成を先に実行し、必要なファイルのみをステージングし(不明なファイルは確認)、実際の差分からコミットメッセージを提案し、コミット後にサマリーを表示してプッシュするか確認するワークフローです。

コミットフロー とは?

このスキルは、ユーザーがコード変更のコミットやステージングを依頼したときに、一貫したワークフローを提供します。まず `gen-docs` スキルを呼び出してドキュメントを更新し、次に `git status` と `git diff` で変更を確認します。ステージングでは、実際に必要なコード変更のみを追加し、関連性が不明なファイルについてはユーザーに確認を求めます。コミットメッセージは実際の差分から自動生成し(例: `feat: add docs for skills a`)、ユーザーの承認を得てから `git commit` を実行し、コミット後にサマリーを表示してプッシュするかどうかを尋ねます。このワークフローは Claude Code や Cursor などのツールで利用でき、`git` コマンドやファイル操作ツールを直接使用して効率的に作業を進めます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/karrot0195/agent-skills-/tree/HEAD/.agents/skills/commit-flow

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コミットフロー は何をしますか?

ユーザーがコミット、ステージング、または変更の準備を依頼したときに使用します。

手順

  1. ドキュメント生成を実行 — まず gen-docs スキルをアクティブ化/実行し、コード変更に基づいてドキュメントを更新します。
  2. 現在の変更を確認 — git status と git diff(または git diff --cached)を実行して、実際に何が変更されたかを確認します。
  3. コードをレビュー — 変更・追加されたファイルを読み、実際に何が必要かを把握します。
  4. 必要なコードのみをステージング — ファイルを直接読み込み、実際に必要な変更を含むファイルのみを追加します。関連性がないように見えるファイル、一時的なファイル、または不明瞭なファイルについては、ユーザーに次のように確認します:「<ファイル> をステージングしますか?内容:<簡潔な要約>」— 勝手に判断しないでください。
  5. メッセージをコード変更に基づかせる — 実際の差分/内容からコミットメッセージを導き出します(例:feat: add docs for skills a)。
  6. ユーザーに確認 — 提案されたメッセージ、ドキュメント生成の結果、ステージングされたファイルを表示し、コミット前に承認(yes/approve)を求めます。
  7. コードをコミット — 承認されたメッセージで git commit を実行し、コミットされた内容の簡潔なサマリーを表示します。
  8. プッシュについて尋ねる — ユーザーにプッシュ(git push)するかどうかを尋ねます。

ルール

  • このフロー内では git、read_file、write_file、およびファイルツールを直接使用します — 各ツール呼び出しのたびに許可を求めないでください。
  • 変更が必要かどうか不明な場合は、「<ファイル> をステージングしますか?内容:<簡潔な要約>」と尋ねてください。
  • コミット前に gen-docs を実行してください。
  • 実際の差分から導き出したコミットメッセージを提案してください(形式例:feat: add docs for skills a)。
  • git commit の前と git push の前にユーザーに確認(yes/approve)を求めてください。その他の手順は直接進めて構いません。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル