ベンダー化されたスキルと上流の同期
前提条件: gh CLI が認証済みであること。すべての操作はリポジトリルートから実行してください。
ワークフロー
-
node scripts/skills-sync.mjs statusを実行します。状態と対応する操作は次のとおりです。up-to-date— 何もする必要はありません。local— 独自のスキルであり、上流はありません。同期は不要です。upstream-updated— 安全な fast-forward が可能です:node scripts/skills-sync.mjs pull <プラグイン>/<スキル>。locally-modified— 最後のベースライン以降に編集されています。編集が意図的なものであれば、node scripts/skills-sync.mjs accept <プラグイン>/<スキル>を実行します。diverged— 両方のサイドで変更が発生しています。手動でマージしてください(以下のセクションを参照)。fetch-error (...)— 上流に到達できないか、移動されています。プラグインのskills-lock.json内のsource/skillPathを上流リポジトリと照合してください。
-
すべての変更後:
node scripts/skills-sync.mjs verifyを実行し、どのスキルをどの上流コミットからプルまたはマージしたかを示すメッセージとともにコミットします。
分岐したスキルの手動マージ
分岐したスキルを決して上書きしないでください。pull --force はカスタマイズを破棄します。
node scripts/skills-sync.mjs diff <プラグイン>/<スキル>— ベンダー化された内容と上流の完全な差分を表示します。- どの差分が私たちの意図的なカスタマイズであり(
git log -p -- <プラグイン>/skills/<スキル>でベンダー化されたコピーの変遷を確認できます)、どれが本物の上流の改善かを特定します。 - ベンダー化されたファイルを編集し、すべてのローカルカスタマイズを保持しながら上流の改善を取り込みます。編集前に両方のバージョンを完全に読んでください。
- 両方のサイドを再ベースライン化します:
node scripts/skills-sync.mjs seed <プラグイン>/<スキル>(acceptはベンダー化されたハッシュのみを再ベースライン化し、スキルが永久に上流更新ありとマークされたままになります)。