ppt-upgrade

インストール済みの paperthin スキルセットを一度の操作で最新にします。名前が変更されたスキルを削除し、その置き換え先だけを追加して、残りを更新し、それ以外は変更しません。

目標

リリース時の名称変更後も、リピーターユーザーがインストール済みの paperthin スキルを最新の状態に保ちます。アップグレードでは、古いローカル名を削除し、ユーザーがすでに持っていた古い名前ごとに対応する置き換え先だけを追加して、インストール済みの現行スキルを更新します。

廃止

この順序付きチェックリストを名称変更の SSOT とします。今後の名称変更は、リリース順にここへ追加してください。

ssot-check の行は、強制プッシュ後の現在の git 履歴では検証できない v0.2.0 より前の履歴について、ユーザーが確認したものです。日付やタグを推測で追加しないでください。

廃止済み	変更後	以降
ssot-check	ssotchk	v0.2.0 より前の履歴（強制プッシュ済み。ユーザー確認済み）
tasting	sip	0.6.0
redteam	hate	0.7.0
scratch	re0-work	0.8.2

現行カタログ

npx skills list とインストール済みスキルディレクトリを解析する際に、このリストを使って現行の paperthin スキルと不明なインストール済み名を区別してください。

autobahn、dedash、factchk、flywheel、hate、mandela、nba、ppt-release、ppt-upgrade、re0、re0-git、re0-work、retro、shower、sip、ssotchk、ssotize

ワークフロー

1. インストール範囲を1つ選び、作業全体を通して同じ範囲を使います。
   • グローバルインストール：npx skills list --global で確認し、~/.agents/skills/<skill>/SKILL.md を調べます。すべての remove、add、update コマンドに --global を指定します。
   • プロジェクトへのインストール：対象プロジェクトから npx skills list を実行し、そのプロジェクトにインストール済みのスキルディレクトリがあれば調べます。--global は指定しません。
   • 特定エージェントへのインストール：--agent claude-code のような明示的なエージェントスラッグのみを使い、--agent '*' は使いません。
2. インストール済みの名前とディレクトリのスラッグの両方を、非推奨チェックリストと照合します。
   • 古い名前とは、Deprecated 列にあるインストール済みの項目またはインストール済みディレクトリのスラッグです。
   • 置き換え後の名前とは、それらに対応する Renamed to の値です。
   • 現行の名前とは、現行カタログにあるインストール済みの項目のうち、非推奨ではないものです。
   • 不明なインストール済みの名前はそのままにします。
3. 変更を加える前に、インストール内容の調整計画全体を報告します。
   • retire：<古い名前>
   • add replacements：古い名前がインストール済みで、置き換え後の名前がまだインストールされていない場合に限り、<置き換え後の名前>
   • update：<インストール済みの現行paperthinスキル>
   • untouched：不明な名前と、ユーザーがインストールしていないpaperthinスキル
4. 削除やインストール内容の調整コマンドを実行する前に、明示的な確認を求めます。
5. 確認後、報告した計画に必要な選択的コマンドのみを、手順1で選んだ同じ範囲指定で実行します。
   • ユーザーが削除を確認した非推奨の名前には、npx skills remove <scope-flags> <stale...> --yes を実行します。
   • インストール済みの非推奨名から導いた置き換え後の名前には、npx skills add LilMGenius/paperthin <scope-flags> -s <renamed-to...> --yes を実行します。
   • 報告した計画に含まれる、すでにインストール済みの現行スキルと置き換え後のスキルのみを更新するには、npx skills update <scope-flags> <current-installed-paperthin...> <renamed-to...> --yes を実行します。
6. npx skills update で特定のスキルの失敗が報告された場合は、同じ範囲指定でそのスキルのみを再試行します。それでも失敗する場合は、スキル名を示してユーザーに確認してから、手順5と同じ skills remove／skills add -s の形式で削除して再インストールし、古い状態のままにしないでください。
7. npx skills list で確認します。非推奨の名前が残っていないこと、期待される各置き換え後の名前が存在すること、インストール済みの現行スキルが引き続き存在すること、変更対象外のスキルが追加されていないことを確認します。
8. 現在のセッションに変更を反映する方法をユーザーに伝えます。Claude Codeでは更新された SKILL.md の内容が現在のセッションに自動で反映されるため、再起動は不要です。ただし、別の実行中のClaude Codeセッションが同じインストールを共有している場合は、そのセッションで /reload-skills を実行します。Codexにはセッション内で再読み込みする機能がないため、変更を反映するにはCodexを再起動するか、codex resume を実行します。それ以外のエージェントでは、新しい動作が反映されない場合にセッションを再起動します。
9. 任意のアップグレード後のGitHubスター付与：確認が正常に完了した後、既定で「はい」とする確認プロンプト Star this repo now? [Y/n] を表示します。ユーザーが Y、y、またはEnterキーを押した場合は、gh api -X PUT user/starred/LilMGenius/paperthin --silent を実行します。ユーザーが n または N と回答した場合は、スター付与をスキップしたことを報告します。gh がない場合、または認証されていない場合は、トークンやAPIの代替手段を使わず、コマンドと gh auth login の案内を表示します。

ルール

• フラットな npx skills add の手順では、このコマンドは /ppt-upgrade としてインストールされます。主要なインストール手順の一部として、paperthin の ppt 名前空間を決して説明しないでください。
• skills add --all は決して実行しないでください。
• 単独の skills add LilMGenius/paperthin は決して実行しないでください。置き換えのインストールでは、必ず -s <skill> を付けてください。
• ワークフローのコマンドとして、ファイルシステムを直接削除するコマンドは使わないでください。確認後、名前を指定して古いスキルを削除するには skills remove を使ってください。
• ユーザーが最新の状態か「念のため」確認するために、カタログ全体をインストールしないでください。以前に選択されていたサブセットを尊重してください。
• 単独の skills update は実行しないでください。報告された計画にある paperthin スキル名のみを渡してください。
• 削除時にエージェントのワイルドカード指定を使わないでください。エージェントのスコープ指定が必要な場合は、明示的なエージェントスラッグを渡してください。そうでなければ、--global またはプロジェクトのスコープを使ってください。
• 廃止予定チェックリストと paperthin カタログのエントリにある名前のみを操作してください。インストール済みの不明な名前には手を加えないでください。
• 廃止予定のディレクトリスラッグは、その SKILL.md の frontmatter にある name がすでに置き換え後の名前になっていても、古いものとして扱ってください。skills remove では廃止予定のスラッグを指定して削除してください。
• 置き換え後のスキルがすでにインストールされている場合、再度追加しないでください。古い名前のスキルを削除し、検証対象に置き換え後のスキルを含めてください。
• gh repo star は実在する gh サブコマンドではありません。スターの手順では、REST エンドポイントを直接使う必要があります：gh api -X PUT user/starred/<owner>/<repo> --silent。
• インストール済みスキルの一覧を確実に解析できない場合は、推測せずに停止し、曖昧な点を報告してください。

検証

完了前に、次のことを行ってください。

1. 古い名前、置き換え後の名前、更新後の現行名、変更しなかった名前を含め、実行した計画を再掲してください。
2. 最終的なインストール済みスキルの一覧とインストール済みディレクトリのスラッグに、「廃止予定」列の名前が含まれていないことを確認してください。
3. インストール済みだった古いスキルの置き換え先がすべて存在することを確認してください。
4. ユーザーが以前インストールしていたサブセットと必須の置き換えを除き、paperthin スキルが追加されていないことを確認してください。
5. 手順 6 で再試行またはフォールバックの手順を取ったスキルが、実際にインストール済みで最新の状態にあることを確認してください。気付かないまま欠落している状態にしないでください。
6. スキップした手順、失敗したコマンド、または未解決の曖昧さがあれば報告してください。