本文へ移動
cccskills
無料GitHub で公開

commit-plan

実装計画・リファクタリング計画・レビュー対応計画・並列作業のタスク分解など、計画を成果物として書き出すときに必ず参照するコミット計画ルール。plan モードでは ExitPlanMode で plan を提示する前に必須、計画ドキュメントや job-graph のタスク分解・エージェントへの指示文でも同様に適用する。

計画成果物にコミット計画セクション(論理的に独立した修正単位での分割と Conventional Commits 形式のメッセージ)が無ければ実装に入らない。

「実装計画を立てて」「planを立てて」「実行計画を作って」「リファクタリング計画を立てて」「コミット計画を立てて」「タスクを分解して」と依頼される、複数の独立した修正をまとめるか分けるか計画段階で判断する等の場面では、ユーザーが「コミット」に一切言及していなくても必ず発火する。

コミットの実施(素材収集・メッセージ確定・git commit 実行)は commit-flow スキルが担う。

インストール方法を見る

含まれるファイル(1)

  • SKILL.md4.9 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

コミット計画ルール

このスキルの目的

計画を立てる作業すべてで、実装ステップと対になるコミット計画を含める。Claude の plan モード(ExitPlanMode で提示する plan)に限らず、計画ドキュメント・並列作業のタスク分解(job-graph の spec・各エージェントへの指示文)など、計画を成果物として書き出す場面すべてが対象。実装ステップだけの計画で実装に入らない。

コミットの実施(素材収集・メッセージ確定・git commit 実行)は本スキルの範囲外で、commit-flow スキルが担う。

1. コミット計画を計画成果物に明示する

実装ステップと対になる「コミット計画」セクションを計画成果物に組み込む。

  • plan モード: ExitPlanMode で提示する plan 本文に含める。含まれていない状態で実装に入らない。
  • plan モード外の計画(計画ドキュメント・タスク分解 spec・サブエージェントや他エージェントへの指示文): 同じ形式のコミット計画を成果物内に含める。plan モードでないことを省略の理由にしない。
## 実装ステップ
1. ドメインモデルに `Foo` を追加
2. リポジトリ層に永続化メソッドを追加
3. ユースケース層から呼び出し
4. テスト追加

## コミット計画
1. `feat(domain): Foo モデルを追加`
2. `feat(infra): FooRepository に永続化メソッドを追加`
3. `feat(usecase): Foo 永続化ユースケースから呼び出し`
4. `test(usecase): Foo 永続化のユースケーステストを追加`

2. 並列作業ではタスク単位に計画する

job-graph 等で作業を並列タスクへ分解するときは、コミット計画もタスク(ブランチ/エージェント)単位で立て、各タスクの指示文(spec の prompt 等)へ含める。タスク間で 1 つのコミット計画を共有しない(ブランチが別なら履歴も別)。各タスク内の粒度は §5 の基準に従う。

3. 粒度判定は計画段階で済ませる

§5 の基準を立案時に適用する。「実装してみないと粒度が分からない」と先送りしない。

4. コミット数を理由に統合しない

分割か統合か未確定で残す場合、粒度に意味があるなら分割を推奨案として書く。コミット数増加はレビュアー追跡性・ロールバック容易性を確保するメリットの方が大きい。

5. コミット粒度の判断基準

分割する: 別の関心事/片方だけ revert したくなる可能性/別 discussion・別 issue の対応。 統合する: 同じ論理変更を機械的に行数で割っただけ/片方だけ戻すと壊れる/同じ discussion 内の一連の修正。

「コミット数が増えるから 1 つにまとめる」は採用しない。

6. 計画時のメッセージ形式

計画に書くメッセージは Conventional Commits 1.0.0 の 1 行形式:

<type>(<scope>): <description>

主要 type: feat / fix / refactor / test / docs / chore / build / ci / perf / style / revert

計画段階ではこの 1 行があれば足りる。body/footer・破壊的変更の書き方・type 選択の詳細は、実施時に commit-flow スキルの references/conventional-commits.md で判断する。

関連スキル

  • commit-flow: コミットの実施(素材収集スクリプト・メッセージ確定・粒度の実施時判断・git commit 実行)
  • job-graph: 並列タスク分解時、§2 に従いタスク単位のコミット計画を各エージェントの指示文へ含める

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

agent-teams

無料日本語概要

Claude Code の並列エージェント(agent teams・teammate)の後始末と無応答時の打ち切りルール。`name` を付けて Agent を起動するとき、TeamCreate でチームを組むとき、teammate から `idle_notification` が届いたとき、評価ループ等で次のイテレーションのエージェントを起動する前、エージェントの返信が届かないときに参照する。`name` を付けない通常のサブエージェント起動だけなら対象外。

yasunori0418/skills82026年10月11日 更新

basic-design

無料日本語概要

spec.md の REQ-# を入力に、機能一覧・モジュール構成・インターフェース・データフローを持つ docs/dev/<対象>/basic-design.md を作成・改訂するスキル。/basic-design <対象名> で明示的に呼び出されたときのみ使用する。

yasunori0418/skills82026年10月11日 更新

biz-translate

無料日本語概要

技術的な内容を、技術用語を排したビジネス職向けの平易な説明文に翻訳する。`/biz-translate` と明示的に呼ばれたときのみ実行する。

yasunori0418/skills82026年10月11日 更新

commit-flow

無料日本語概要

`git commit` / `git commit --amend` を実行する前、または「commit」「amend」「コミット」「コミットして」の一語・短文だけを渡された時点で必ず発火する git コミット実施ルール。理由や差分の説明が一切無くても、ファイル全文を読んでメッセージを組み立てる前に先に参照する。主目的は論理的に独立した修正を都度・適切な粒度でコミットすること。メッセージは Conventional Commits 形式、素材は同梱の決定論スクリプト commit-context.sh が出す staged diff のみ。「コミット分けて」と依頼される、独立した複数修正をまとめるか分けるか判断する、レビューコメント対応をコミットする、rebase / squash / cherry-pick 後のメッセージを整える、`gh pr create` の PR タイトルをコミット流儀へ揃える場面でも参照する。plan モードでのコミット計画の立案は commit-plan スキルの領分。

yasunori0418/skills82026年10月11日 更新

def-done

無料日本語概要

プロジェクトに 1 つの「完成の定義」docs/dev/definition-of-done.md を対話で構築・改訂し、機械判定節と人判定節の二部構成で書き出すスキル。/def-done で明示的に呼び出されたときのみ使用する。

yasunori0418/skills82026年10月11日 更新

diff-review

無料日本語概要

「レビューして」「diff をレビュー」「〇〇観点で見て」「PR に出す前にセルフレビュー」などユーザーがコードレビューを依頼したら、観点・レンズ名を挙げていなくても必ず使用する。作業ブランチの diff を複数観点(design / test / yagni、条件付きで spec 等)で並列レビューし統合報告するオーケストレーションスキル。既定は diff 内で完結する fix 指摘のみで、既存コードへの改善提案(リファクタ候補の洗い出し)は起動引数 --improvement の明示時のみ報告する。コードの修正は行わない。

yasunori0418/skills82026年10月11日 更新

yasunori0418 のスキルをすべて見る

このスキルの問題を報告する