money-upgrade

Money Upgrade — 自動アップデーター

1 つのコマンドですべての money-* スキルを最新の公開バージョンに更新できます。手動でファイルをコピーしたり、バージョンを手作業で比較したりする必要はなく、不完全なインストールが発生する心配もありません。

言語の選択

ユーザーのメッセージに [Language: ...] タグが含まれている場合は、すべての出力にその言語を使用してください。それ以外の場合は、続行する前にユーザーに言語を選んでもらいます。

🌐 言語を選択してください / 选择语言:

1. 🇬🇧 英語
2. 🇨🇳 中国語

ユーザーが指定しない場合は、英語をデフォルトにします。それ以降の出力には、選択した言語を使用してください。

このスキルの機能

ユーザーが /money-upgrade を実行したら、次の 3 つの手順を順番に実行します。

1. インストール済みバージョンを読み取る — ファイルが存在する場合は cat ~/.claude/skills/money/../../VERSION を実行し、存在しない場合はパッケージのメタデータから読み取ります
2. npm で最新バージョンを確認する — npm view @orrisai/show-me-the-money version
3. 古いバージョンの場合、自動アップデーターを実行する — npx @orrisai/show-me-the-money@latest update

CLI（bin/cli.js）がダウンロード、バージョン比較、バックアップ、インストールの実作業を処理します。このスキルは、いつ CLI を呼び出すかを判断する、ユーザー向けのラッパーです。

自動アップデートコマンドの全体

バージョンの確認、ダウンロード、置き換え、検証をすべて実行する単一のコマンドです。

npx @orrisai/show-me-the-money@latest update

ユーザーのために実行してください。更新前後のバージョンと、再インストールされたスキルの一覧が表示され、正常に終了します。

ワークフロー

ステップ 1 — 現在の状態を表示する

Current installation:
  Version: v{current}
  Location: ~/.claude/skills/
  Skills installed: {count}

Checking npm for updates...

ステップ 2 — 更新を確認する

npm view @orrisai/show-me-the-money version を実行します（引数は不要です）。標準出力を取得し、ローカルの VERSION と比較します。

一致する場合は、次のように表示して終了します。

✅ You're on the latest version (v{version}). Nothing to update.

異なる場合（local < remote）は、ステップ 3 に進みます。

ステップ 3 — アップデーターを実行する

npx @orrisai/show-me-the-money@latest update

CLI によって進行状況が表示されます。処理が戻ったら、成功を確認します。

• VERSION が最新の npm バージョンと一致していることを確認します
• すべてのスキルディレクトリが ~/.claude/skills/ に存在することを確認します

ステップ 4 — 変更点を表示する

更新が成功したら、新しいバージョンのリリースノートを取得して要約します。

curl -s https://raw.githubusercontent.com/iamzifei/show-me-the-money/v{version}/CHANGELOG.md | head -80

CHANGELOG.md が利用できない場合は、README の「新機能」セクションを代わりに使用します。差分全体ではなく、主な変更点を 5～10 個の箇条書きで示します。

ステップ 5 — 再起動を促す

✅ Updated to v{new}.

To pick up the new skills, restart Claude Code (or run /reload-plugins if available).

What's new in this version:
- [bullet 1]
- [bullet 2]
- ...

Run /money to start using the updated suite.

手動での代替手順

自動アップデーターに失敗した場合（npm がオフライン、レジストリの問題、権限エラーなど）は、手動の手順に切り替えます。エラーメッセージを読み、失敗の具体的な理由を 1 つだけ伝えてください。一般的な復旧方法を並べ立てないでください。

よくある失敗と対応：

失敗	診断	対応
npm: command not found	Node/npm がインストールされていない	"まず nodejs.org から Node.js をインストールしてから、/money-upgrade を再実行してください。"
ネットワークに接続できない	インターネット接続がないか、npm レジストリが停止している	"npm レジストリに接続できません。ネットワークを確認してください — レジストリのステータス：https://status.npmjs.org。"
~/.claude/skills/ で EACCES	skills ディレクトリへの書き込み権限がない	"~/.claude/skills/ への書き込みが拒否されました。sudo chown -R $(whoami) ~/.claude/ を実行してから、再度実行してください。"
タグは存在するが、インストールに失敗する	公開処理の競合、またはリリースの破損の可能性が高い	"最新リリースのインストールに問題があります。以前のバージョンを指定するには、npx @orrisai/show-me-the-money@{previous-stable} を実行してください。"

ロールバック

新しいバージョンによって問題が発生した場合は、以前のバージョンに明示的にロールバックします。

# 1. Find the previous stable version on npm
npm view @orrisai/show-me-the-money versions --json | tail -20

# 2. Install that specific version
npx @orrisai/show-me-the-money@{previous-version} install

自動アップデーターは、失敗時に自動でロールバックしません。失敗したインストールが終了した時点の状態で、インストールを維持します。更新後にユーザーから不具合の報告があった場合は、上記の 2 段階のロールバックを実行してから、https://github.com/iamzifei/show-me-the-money/issues にイシューを登録してください。

自動更新するか、先に確認するか

デフォルトでは、更新前に確認します。ユーザーが /money-upgrade を実行したので、更新を希望していますが、先にバージョンの差分を示し、確認してもらってください。例：

Current: v2.3.1
Latest:  v2.4.0  ← 1 minor version behind

New in v2.4.0:
- Tech-triage mode for technical debugging
- DESIGN.md design system contract in money-product
- Ship lifecycle: VERSION + CHANGELOG + release notes flow
- Cross-project portfolio learnings via /money-learn promote
- STRIDE threat model in money-quality
- Operating modes + edit perimeter + panic stop in money-ops

Proceed with update? [y/n]

ユーザーのメッセージに --yes、--auto、または「そのまま更新して」と明示されている場合に限り、確認を省略してください。

原則

• 1 つのコマンドで、1 つの結果 — ユーザーに複数のシェルスニペットのコピーを求めないでください
• 変更前に差分を示す — バージョン番号と主な変更点を示し、完全な差分は表示しません
• 自動でロールバックしない — インストールに失敗した場合は失敗として伝え、ロールバックはユーザーが明示的に行います
• 最後に再起動を促す — スキルはセッション中に再読み込みされるとは限らないため、ユーザーに知らせます
• コミットログではなく、CHANGELOG を読む — ユーザーが知りたいのは実装の変化ではなく、動作の変更です

---

価値の定量化（出力の最後に必須）

• ⏱ 節約できる時間 — 手動でのアップグレード手順（バージョンの比較、バックアップ、インストール、検証、リリースノートの確認）と比べて約 10～15 分
• ⚠️ 回避できるリスク — （1）一部のスキルだけが更新され、ほかは更新されない不完全なインストール、（2）間違ったディレクトリをバックアップしてプロジェクトローカルのスキルを失うこと、（3）古いスキルと新しいスキルを同時に実行し、動作に一貫性がなくなること
• ✅ 得られるもの — v{current} から v{new} へのクリーンな更新、関連する CHANGELOG の箇条書き、再起動の促し
• 🚧 このスキルがない場合 — 多くのユーザーは更新を数週間先延ばしにし、古いスキルを新しいドキュメントやアトムに対して実行します。その結果、「v2.1 を使っているため、v2.3 でそのフィールド名が変更された」といった原因不明のバグが発生します