mcpField
C
changeset

changeset

github.com/venhdev開発1135 回インストール今日更新
リポジトリ

changeset について

合意済みの解決策を、読み取り専用のファイル単位の変更計画にする開発スキルです。影響範囲と必要な連鎖変更を追跡し、方針が古い、または矛盾する場合は未解決として報告します。

主な機能

  1. 01呼び出し元、実装、スキーマ、テストの追跡
  2. 02作成、移動、更新、削除の分類
  3. 03必要な連鎖変更の計画
  4. 04古い方針や矛盾の検出
  5. 05ステージ済み変更ツリーの作成

活用シーン

  1. 01承認済み解決策の影響ファイルを計画
  2. 02ロジック変更で無効になるテストを特定
  3. 03古い実装計画の阻害要因を提示
  4. 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)。

実行プロトコル

  1. 提示された方針と現在のコード/契約を調査します。古い計画または根本的な矛盾があれば停止し、必要な再設計の判断を示して UNRESOLVED を報告します。
  2. ファイル操作、直接的なカスケード、受け入れ基準、証拠の出所を含むツリーを作成します。ファイル階層を保ちながら、冗長なディレクトリをまとめます。
  3. STAGED を提示して終了します。ファイルシステムは変更しません。別の場所で作成された変更セットが埋め込まれている場合も、このスキルの引き継ぎ要件を適用します。

コメント