mcpField
N
npm-publish

npm-publish

github.com/b-open-io開発1698 回インストール4 週間前に更新
リポジトリ

npm-publish について

npm-publish は、npm パッケージの事前確認から変更履歴の更新、公開、検証までを案内するスキルです。公開とトークン設定をスクリプトで進め、認証状況をユーザーに伝える手順も定めています。

主な機能

  1. 01レジストリのバージョン確認と更新
  2. 02ビルドと変更履歴の手順
  3. 03スクリプトによるコミットと公開
  4. 04ブラウザーでのトークン設定
  5. 05バックグラウンドでの公開検証

活用シーン

  1. 01バージョンを更新してパッケージをリリース
  2. 02コミット内容を記録して公開
  3. 03認証エラーからの公開復旧
  4. 04公開済みパッケージの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/b-open-io/prompts --skill npm-publish

インストール後、Claude Code で/npm-publishを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
.clawnet/
unsigned-skill.json
scripts/
preflight.sh
publish.sh
release.sh
setup-token.sh
verify.sh

詳細

npm-publish

必須 — 作業を始める前にお読みください

ユーザーに OTP コードを尋ねないでください。 認証はスクリプトと agent-browser で処理します。

npm whoami、npm view、bun publish、npm publish のようなコマンドを手動で実行しないでください。

必ずこれらのスクリプトを実行してください。手順を省略しないでください。

手順 1：事前確認

bash ${CLAUDE_SKILL_DIR}/scripts/preflight.sh

npm レジストリに対するバージョン確認、必要に応じたバージョンの更新（差分をリセット）、ビルド、コミットログの出力を確実に処理します。デフォルトのパッチバージョン更新を上書きするには、minor または major を渡します。

手順 2：変更履歴を作成

事前確認の出力からコミットログを読み取ります。CHANGELOG.md が存在する場合は、既存の形式に合わせて先頭に項目を追加します。存在しない場合は作成します。事前確認の出力にあるバージョンを使用します。カテゴリは次のとおりです：Breaking Changes、Added、Changed、Fixed、Security、Deprecated。

手順 3：リリース（コミット＋プッシュ＋公開）

bash ${CLAUDE_SKILL_DIR}/scripts/release.sh [--access public]

コミットしてプッシュした後、publish.sh を呼び出します。publish.sh が PUBLISH_SUCCESS を出力した場合は完了です。手順 4 に進みます。

publish.sh が AUTH_FAILED を出力した場合

エージェントがトークンの設定を進行する必要があります。setup-token.sh を長いコマンドとして一度に呼び出さないでください。 ユーザーへの連絡を間に挟み、2 段階で実行します。

フェーズ 1 — フォームに入力：

bash ${CLAUDE_SKILL_DIR}/scripts/setup-token.sh fill

ステータスコード：

  • FORM_READY:<username> — Chrome でフォームへの入力が完了しました。ユーザーに伝えてください
  • NOT_LOGGED_IN — ユーザーに「Chrome で npmjs.com にサインインしてください。その後、再試行します」と伝えてください
  • FORM_NOT_FOUND — ユーザーに「トークンフォームが見つかりませんでした。ページが変更された可能性があります」と伝えてください

FORM_READY を受け取ったら、直接ユーザーに伝えてください（bash コマンド内ではなく）：

Chrome で npm トークン作成フォームを開き、入力しました（cli-publish、7 日間、読み取り＋書き込み、すべてのパッケージ）。準備ができたら下にスクロールして、Generate token をクリックしてください。

フェーズ 2 — トークンを取得：

bash ${CLAUDE_SKILL_DIR}/scripts/setup-token.sh capture

ページにトークンが表示されるまでポーリングし、Copy ボタンをクリックしてクリップボードから読み取り、~/.npmrc に書き込み、クリップボードを消去します。トークンがターミナル出力に表示されることはありません。

ステータスコード：

  • TOKEN_SAVED — 成功しました。公開を再試行してください
  • CAPTURE_TIMEOUT — ユーザーに「トークンを取得できませんでした。Chrome からコピーしてください。~/.npmrc に書き込みます」と伝えてください

TOKEN_SAVED の後、公開を再試行：

bash ${CLAUDE_SKILL_DIR}/scripts/publish.sh [--access public]

ユーザーに「ブラウザーに OTP チェックボックスが表示された場合は、完了してください」と伝えてください。

手順 4：検証（バックグラウンド）

bash ${CLAUDE_SKILL_DIR}/scripts/verify.sh <package-name> <version>

run_in_background: true を指定して実行します。指数バックオフ（5s、10s、20s、40s、60s）を使用します。

重要なアーキテクチャ原則

スクリプトはステータスコードを出力します。エージェントはそれを解釈し、ユーザーに伝えます。 スクリプトの出力は折りたたまれた bash コマンド内に隠されており、ユーザーには表示されません。ユーザー向けの連絡はすべて、bash 呼び出しの外でエージェントが直接行う必要があります。

コメント

Markdown 対応