update について
ai-video-editor-cooked の Marketplace インストール、クローン、フォークの更新を進める Claude スキルです。ユーザーの変更を保ちながら更新をマージし、検証とロールバックも行います。
主な機能
- 01インストール形式の判定
- 02コミットと変更履歴の確認
- 03ユーザー変更を保った更新のマージ
- 04ファイル単位の競合解決
- 05更新の検証と必要時のロールバック
活用シーン
- 01Marketplace インストールの更新
- 02フォークへの上流変更の取り込み
- 03更新が変更済みファイルに与える影響の確認
- 04検証失敗後の状態復元
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ nextwork-projects/ ai-video-editor-cooked --skill updateインストール後、Claude Code で/updateを入力して読み込まれたか確認します。
同梱ファイルscripts/update.py
詳細
更新
パス:${CLAUDE_SKILL_DIR} はこの SKILL.md を含むフォルダーを意味し、${CLAUDE_PLUGIN_ROOT} はその 2 階層上にあるプラグインフォルダーを意味します。
質問はすべて質問ボックスに入力します:AskUserQuestion ツール(選択肢は 2~4 個で、おすすめを最初にします)。このツールがないエージェントでのみ、テキストで番号付きの質問をします。
U="${CLAUDE_SKILL_DIR}/scripts/update.py"。Mac と Linux では python3、Windows では py で実行します。
ユーザーのクローンが Claude Code の実行フォルダーと異なる場合は、--repo <folder> を追加します。
プッシュ、強制プッシュ、ブランチの削除、ユーザーの未コミット作業のスタッシュやリセットは、決して行いません。ユーザーのフォークへのプッシュは、ユーザーから依頼があった場合にのみ行います。
1. インストール方法
python3 "$U" where
- マーケットプレイス:
python3 "$U" marketを実行します。このコマンドはclaude plugin marketplace update nextworkを実行し、続いてai-editor@nextworkとcreator-teardown@nextworkに対してclaude plugin updateを実行します。その後、/reload-pluginsと入力するよう伝えます。失敗した場合は、代わりに出力された行を伝えます。スタイル、スキル、設定はユーザー自身のフォルダーにあり、そのまま保持されます(docs/customise.md)。ここで終了します。 - 通常のクローン:出力された 3 つのフォーク手順を伝えます。ここで終了します。
- フォークがあり、そのクローンの外で実行している場合:クローンのフォルダーを尋ねてから、
--repoを使用します。 - フォークに upstream がない場合:「
nextwork-projects/ai-video-editor-cookedをupstreamとして追加して、そこから更新を取得できるようにしますか?」と尋ねます(はい、追加する(おすすめ) / いいえ)。「はい」の場合:python3 "$U" add-upstream。
2. 確認
python3 "$U" check
新しいコミットの数、追加される CHANGELOG の内容(平易な言葉で、ユーザーが気づく点)、更新によって変更されるユーザー側のファイルを、数行で伝えます。その後、今すぐ更新する(おすすめ) / 今はしない と尋ねます。
3. マージ
python3 "$U" merge
- 終了コード 2、未コミットの変更あり:出力された内容を表示します。「my changes」としてコミットする(おすすめ) / 自分で対応する と尋ねます。「はい」の場合にのみコミットし、その後、再度マージします。スタッシュは決して行いません。
- 終了コード 0:手順 4 に進みます。
- 終了コード 3、競合あり:ファイルごとに解決します。各ファイルについて、ユーザーの変更を残し、upstream の修正を取り込み、実施内容を 1 行で伝えます(「captions.tsx:フォントは維持し、新しいセーフゾーン修正を取り込みました」)。実際に競合し、どちらを選ぶかユーザーが決める必要がある場合(同じ設定を双方が異なる値に変更した場合)は、質問ボックスで双方の選択肢を提示し、ユーザー側を先にします。その後、各ファイルに対して
git addを実行し、git commit --no-editを実行します。
バックアップブランチは before-update-<date> です。ブランチ名は 1 回だけ伝えます。
4. 検証
python3 "$U" verify
tests/check_plugins.py と tests/demos.sh を実行します。成功した場合:/reload-plugins と入力するよう伝えます(GitHub のフォークからインストールした場合は、希望するタイミングでフォークにプッシュし、/plugin marketplace update nextwork を実行すると反映されることも伝えます)。失敗した場合:失敗したチェック項目を表示し、修正する(おすすめ) / 更新前の状態に戻す と尋ねます。元に戻す場合:
python3 "$U" rollback
未完了のマージを中止するか、ブランチをバックアップの状態に戻します。ブランチは削除しません。