changeset について
合意済みの解決策を、読み取り専用のファイル単位の変更計画にする開発スキルです。影響範囲と必要な連鎖変更を追跡し、方針が古い、または矛盾する場合は未解決として報告します。
主な機能
- 01呼び出し元、実装、スキーマ、テストの追跡
- 02作成、移動、更新、削除の分類
- 03必要な連鎖変更の計画
- 04古い方針や矛盾の検出
- 05ステージ済み変更ツリーの作成
活用シーン
- 01承認済み解決策の影響ファイルを計画
- 02ロジック変更で無効になるテストを特定
- 03古い実装計画の阻害要因を提示
- 04実装前にファイル単位の引き継ぎを準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ venhdev/ skills --skill changesetインストール後、Claude Code で/changesetを入力して読み込まれたか確認します。
詳細
changeset — ファイルへの影響とカスケード計画
ドメインの評価基準
入力と境界
成果、制約、利用可能な証拠を含む、確定済みの方針または解決策を受け取ります。現在のチェックアウトと適用される契約に照らして根拠を確認し、計画は読み取り専用で進め、提示された方針を維持します。
直接および間接の呼び出し元、実装、インポート、スキーマ、テストを追跡します。対象と、影響の大きいカスケードのみを調査し、見た目だけの変更、推測に基づくファイル、影響を受けない後方互換の呼び出し元は除外します。不要になったロジックを整理します。不要なヘルパー、廃止された分岐、解決策によって無効になるテストは、明示的に削除対象にします。入力された計画が古い、または矛盾している場合は、暗黙に再設計せずに停止します。
ファイル操作
[CREATE]:解決策で必要となる新規ファイル。[MOVE]:移動または名前変更。影響を受ける参照も含みます。[UPDATE]:既存のロジック、契約、テスト、または必要なカスケード。[DELETE]:解決策の実施にあたり削除が必要な不要ファイル。
状態
STAGED:Changeset Tree に、確定済みの方針に必要な具体的な操作とカスケードが示されています。UNRESOLVED:方針の不足、古さ、または矛盾により、信頼できる変更セットを作成できません。阻害要因と必要な判断を明記します。
標準出力の契約
# Changeset: <Scope> · STAGED
Basis: <Settled solution and supporting proof/reference.>
Acceptance: <Observable criteria and constraints to carry downstream.>
```text
|-- <subsystem>/
| |-- <file>
| | `-- [UPDATE] <Load-bearing change and invariant>.
| `-- <new-file>
| `-- [CREATE] <Required component or regression check>.
`-- <deep/path/to/caller>
`-- [UPDATE] <Necessary cascade>.
Summary: <N> files affected (<C> created, <U> updated, <M> moved, <D> deleted).
```
UNRESOLVED の場合は、ツリーを簡潔な阻害要因、証拠、必要な再設計の判断に置き換えます。推測によるファイル操作は記載しません。
振り分け
- 古い計画に未解決の要件がある →(via /clarify)。
- 古い計画に新たな設計方針が必要 →(via /architect-decision)。
- 根拠のある変更セットが実装用に承認されている →(via /forge)。
- 呼び出し元が進捗管理または有用なタスク分解を希望している →(via /to-tasks)。
実行プロトコル
- 提示された方針と現在のコード/契約を調査します。古い計画または根本的な矛盾があれば停止し、必要な再設計の判断を示して
UNRESOLVEDを報告します。 - ファイル操作、直接的なカスケード、受け入れ基準、証拠の出所を含むツリーを作成します。ファイル階層を保ちながら、冗長なディレクトリをまとめます。
STAGEDを提示して終了します。ファイルシステムは変更しません。別の場所で作成された変更セットが埋め込まれている場合も、このスキルの引き継ぎ要件を適用します。
コメント
Markdown 対応