re0-upgrade

現在の paperthin カタログ全体へ、1 ステップでインストールを収束させます。名前が変更されたスキルを廃止し、まだインストールされていないすべてのスキルを追加し、残りを更新します。そのすべてを 1 回の確認の背後で行います。

目標

選択したスコープを、最初にインストールされたサブセットだけでなく、現在のカタログ全体へアップグレードします。確認の前に突き合わせプランを表示し、ユーザーにとって新規のスキルをすべて明示します。より狭いインストールを希望するユーザーは辞退できます。

非推奨

名前変更の SSOT を、リリース順に示します。今後の名前変更はここに追記し、チェーンを最終的な現在の名前に解決します。ssot-check の行は v0.2.0 より前のユーザー確認済みの履歴であり、force-push 後は git で検証できません。その日付やタグを捏造しないでください。

非推奨	名前変更後	導入時期
ssot-check	ssotchk	v0.2.0 より前の履歴 (force-push 済み、ユーザー確認済み)
tasting	sip	0.6.0
redteam	hate	0.7.0
scratch	re0-work	0.8.2
retro	re0-memo	0.11.0
flywheel	re0-loop	0.11.0
ssotchk	ssotize	0.11.0
ppt-upgrade	re0-upgrade	0.11.0
ppt-release	re0-release	0.11.0

現在のカタログ

確認時に辞退されたものを除き、選択したスコープに以下のすべてのスキルをインストールします。この一覧を使用して、npx skills list およびインストール済みディレクトリ内で、現在の名前と不明な名前を区別します。

re0, readchk, aim, modelchk, hate, macrothink, feynman, autobahn, reorder, detool, dedash, debloat, shower, factchk, mandela, sip, re0-git, re0-release, re0-merge, ssotize, re0-upgrade, re0-plan, re0-loop, re0-memo, re0-work, catchup, nba, prism

ワークフロー

1. 実行全体を通して 1 つのインストールスコープを選択します。指定がない場合は確認してください。スコープを誤ると、誤ったインストール場所を読み取ります。
   • グローバル: npx skills list --global を実行し、~/.agents/skills/<skill>/SKILL.md を確認し、すべての remove、add、update に --global を渡します。
   • プロジェクト: そのプロジェクトで npx skills list を実行し、存在する場合はそのインストール済みスキルディレクトリを確認し、--global を省略します。
   • 特定のエージェント: --agent claude-code のような明示的なスラッグを使用し、削除を含めて --agent '*' は決して使用しません。エージェントスコープがない場合は、グローバルスコープまたはプロジェクトスコープを使用します。
2. 分類する前に、シャドウインストールを確認します。 paperthin がロードされているのに、選択したスコープのリストで paperthin スキルが 0 件と報告された場合、カタログ全体が欠落していると結論付けないでください。そのスコープの管理対象領域 (グローバルでは ~/.agents/skills/、例: ~/.agents/skills/re0) に現在のカタログのディレクトリがないか確認します。
   • ディレクトリが存在する: スコープを再確認し、リストを再試行します (グローバルでは npx skills list --global)。それでも領域と矛盾する場合は、CLI の失敗を報告して停止します。不安定な読み取りは、空のインストールではありません。
   • ディレクトリが存在せず、paperthin がロードされている: シャドウインストールを報告します。これは一般に、Claude Code プラグインとしてロードされたクローン (/paperthin:<skill>) です。CLI からはそれを認識、更新、削除できません。選択したスコープで npx skills add による管理対象の再インストール (今後のアップグレードと検出通知のために推奨) を提案するか、クローンをそのままにして CLI からは見えない状態を保ち、アップグレードのたびにそれを再フラグするかを選べます。ユーザーの選択を待ってください。クローンを削除したり、独自に 2 つ目のコピーをインストールしたりしないでください。 管理後は、インストール済みの名前とディレクトリスラッグの両方を Deprecations と Current カタログに対して分類します:
   • stale: 非推奨の名前またはスラッグ。
   • missing: リネームチェーンを解決した後、インストールされていない Current の名前。すでにインストール済みの代替は present と見なされ missing ではないため、stale な名前のみを退役させ、代替を再度追加しないでください。
   • present: Current かつインストール済みで非推奨でない名前。
   • unknown: Current でも非推奨でもない名前。手を付けずにそのままにします。
3. 変更前に調整プランを出力します: まずスコープ (global / project / exact agent)、次に:
   • retire: stale な名前。
   • add (new to you): missing なカタログ名を完全に (退役させた名前の代替も含む)。
   • refresh: present な名前。
   • untouched: unknown な名前。
   • wire discovery notice: 手順 9 で接続する present なエージェント、辞退した場合は none。
4. 削除、インストール、更新、またはフック接続の前に明示的な確認を取得します。フルカタログの収束とディスカバリ接続を推奨します。ユーザーはプランを承認するか、実行全体を辞退するか、接続のみを辞退することができます。承認前に何も変更されません。
5. 確認後、手順 1 で選択したスコープフラグを付けて、プランで指定されたコマンドのみを実行します:
   • retire グループには npx skills remove <scope-flags> <stale...> --yes。
   • add グループには npx skills add LilMGenius/paperthin <scope-flags> -s <missing...> --yes、各カタログ名をそれぞれの -s で列挙します。
   • refresh グループには npx skills update <scope-flags> <present...> --yes。
6. npx skills add または npx skills update が失敗したスキルを報告した場合、同じスコープフラグでそのスキルのみを再試行します。再度失敗した場合、スキル名ごとに確認を取得し、同じ skills remove/skills add -s の形式で削除して再インストールします。
7. npx skills list で検証します: 非推奨の名前が残っていないこと、すべての Current カタログスキルがインストールされていること、unknown な名前が手を付けられずに残っていること、再試行/フォールバックの経路をたどったスキルが実際に存在すること。
8. 更新を反映する方法を説明します: Claude Code はこのセッションで変更された SKILL.md の内容を自動的に適用します。インストールを共有する他の実行中の Claude Code セッションでは /reload-skills を実行してください。Codex にはセッション内リロードがないため、再起動します (または codex resume)。その他のエージェントでは、新しい動作が現れない場合は再起動してください。
9. アップグレード検証が成功した後、辞退されない限り、present なエージェントに対してセッション開始時のディスカバリ通知を接続します。編集前に各設定をバックアップします。
   • https://raw.githubusercontent.com/LilMGenius/paperthin/v<installed-version>/scripts/<file> から catalog.cjs と session-check.cjs、および OpenCode の場合のみ opencode-discovery.js を ~/.re0/ に取得します。固定されたインストール済みリリースタグを使用し、決して main を使用しないでください。
   • Claude Code (~/.claude/settings.json) および Codex (~/.codex/config.toml): session-check.cjs を いかなるパスでも実行する SessionStart コマンドがまだ存在しない場合にのみ、~/.re0/session-check.cjs 用の SessionStart コマンドを追加します。リネーム前の接続は独自のランタイム上に維持してください。重複すると二重に発火します。
   • OpenCode (opencode.json/opencode.jsonc): opencode-discovery.js のエントリが いかなるパスでも存在しない場合にのみ、~/.re0/opencode-discovery.js を plugin に追加します。
   • Copilot CLI (セッション開始フックの出力を無視)、Antigravity CLI (セッション開始イベントなし)、Grok Build (フック形式が未検証) はスキップします。サポートされている 3 つのエージェントのみを接続します。
   • 他のツールのフックを決して削除または上書きしないでください。競合を報告し、手を付けずに残します。何を接続したか、どのファイルが変更されたか、接続解除の方法を報告します。
10. オプションの GitHub スター。 アップグレード検証が成功し、アップグレード/ディスカバリの結果を報告した後、ホストの構造化ユーザー質問ツールを一度使用します: 「認証済みの gh アカウントを使用して LilMGenius/paperthin に GitHub でスターを付けますか?」 「Star repository」を提示し、次に「Skip」を提示します。スターは任意であり、スキップしてもアップグレードは変わらないことを説明します。

• 選択が送信されるまで中断します。保留中の質問については、ホストの入力フローに譲り、その回答で再開します。送信された「Star repository」のみがアクションを承認し、事前選択、沈黙、アップグレードの承認、インストールの --yes は決して承認しません。
• ツールが利用できない場合、実行が無人である場合、または結果がその選択以外 (スキップ、キャンセル、セッション終了、タイムアウト、自由記述を含む) である場合はスキップします。質問の繰り返し、チャットでの代用、同意の解析、代替入力方法は行いません。
• 承認後、gh auth status --hostname github.com を確認します。gh が存在しないか認証が失敗した場合はスキップし、ユーザーが実行できるように gh auth login --hostname github.com とスターコマンドを提示します。決してログインしたり、トークンを読み取ったり、API クライアントを切り替えたりしないでください。辞退の場合、コマンドもログインの促しも提供しません。
• 承認と有効な認証があれば、gh api --hostname github.com -X PUT user/starred/LilMGenius/paperthin --silent を一度実行します。--silent はレスポンス本文のみを非表示にします。コマンド成功時は「star is set」と報告し、「newly added」とは報告しません。失敗は個別に報告します。スターの結果はアップグレードやゲート通知の接続をブロックしたり取り消したりすることは決してありません。

ルール

• npx skills add のフラットなパスでは、このコマンドを /re0-upgrade としてインストールします。ppt 名前空間を含む paperthin のパスを、主要なインストールパスとして説明してはいけません。
• Deprecations チェックリストと Current カタログにある名前のみを対象にしてください。不明なインストール済みの名前はそのままにします。収束先は paperthin カタログのみです。
• 非推奨のディレクトリスラッグは、SKILL.md のフロントマターにある name がすでに置き換え後の名前になっていても、古いものとして扱います。skills remove で非推奨のスラッグを指定して削除してください。
• インストール済みスキルの一覧を確実に解析できない場合は、推測せずに中止して、曖昧な点を報告してください。
• ワークフローのコマンドとして、生のファイルシステム削除コマンドを使用しないでください。確認後、名前を指定した古いスキルの削除には skills remove を使用してください。
• skills add --all や、skills add LilMGenius/paperthin のみの実行は禁止です。カタログの各名前を個別の -s <name> で指定してください。これにより、インストール対象は --all のより広い意味ではなく、このスキルの Current カタログによって定義されます。
• skills update のみを実行しないでください。報告した計画に含まれる、現在の paperthin スキル名だけを渡してください。
• gh repo star は実在する gh サブコマンドではありません。ワークフローのステップ 10 では、同意を得てから REST コマンドを使用してください。

検証

完了前に、次を確認してください。

1. 実行した計画を再掲します。削除した名前、新たに追加した名前、更新した名前、変更せずに残した名前を示してください。
2. 最終的なインストール済み一覧とインストール済みのディレクトリスラッグに、Deprecated 列の名前が含まれていないこと、Current カタログのすべてのスキルがインストールされていること、ステップ 6 の再試行／フォールバック経路を通ったスキルが、存在し、最新の状態であることを確認してください。
3. 確認ゲートが守られていることを確認してください。計画を提示して承認を得る前に、何も削除、追加、更新されておらず、計画には add (new to you) グループが表示されている必要があります。
4. ユーザーが承諾した場合、検出通知の設定が、設定済みの各エージェントに一度だけ反映され、バックアップされ、バージョンが固定され、外部のフックに変更が加えられていないことを確認してください。あるいは、正しくスキップされたこと（ユーザーが辞退した、またはエージェントが存在しなかった）を確認してください。
5. オプションのスター付けは、構造化質問ツールで肯定の選択が送信された場合にのみ実行されているか、スキップされていることを確認してください。その結果はアップグレードの成功とは別に報告してください。
6. スキップしたステップ、失敗したコマンド、未解決の曖昧な点があれば報告してください。