jpskill.com
🛠️ 開発・MCP コミュニティ

changesets

JavaScript/TypeScriptのモノレポで、Changesetsを使ってバージョン管理や変更履歴の作成を支援し、PRから変更履歴を生成したり、複数のパッケージのリリースやnpmへの公開を自動化したりするSkill。

📜 元の英語説明(参考)

Assists with managing versioning and changelogs in JavaScript/TypeScript monorepos using Changesets. Use when automating semantic versioning, generating changelogs from PRs, coordinating multi-package releases, or publishing to npm. Trigger words: changesets, versioning, changelog, npm publish, monorepo release, semver.

🇯🇵 日本人クリエイター向け解説

一言でいうと

JavaScript/TypeScriptのモノレポで、Changesetsを使ってバージョン管理や変更履歴の作成を支援し、PRから変更履歴を生成したり、複数のパッケージのリリースやnpmへの公開を自動化したりするSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o changesets.zip https://jpskill.com/download/14733.zip && unzip -o changesets.zip && rm changesets.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/14733.zip -OutFile "$d\changesets.zip"; Expand-Archive "$d\changesets.zip" -DestinationPath $d -Force; ri "$d\changesets.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して changesets.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → changesets フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Changesets

概要

Changesets は、JavaScript/TypeScript のモノレポのためのバージョン管理および変更ログ管理ツールです。開発者は変更内容を記述した changeset ファイルを追加し、CI がそれらを消費して、パッケージのバージョンを上げ、変更ログを生成し、依存関係のあるパッケージ間で連携したリリースで npm に公開します。

手順

  • 変更を追加する際は、npx changeset を実行し、影響を受けるパッケージを選択し、セマンティックバージョニングの bump タイプ (patch, minor, major) を選択し、ユーザー向けの記述を書き、生成された .changeset/xxx.md ファイルを PR と共にコミットします。
  • バージョンをリリースする際は、npx changeset version を実行して、保留中の changesets を消費し、package.json のバージョンを上げ、パッケージごとに CHANGELOG.md を更新し、依存関係の bump を自動的に処理します。
  • 公開する際は、npx changeset publish を実行して、変更されたパッケージを npm に公開し、git タグを作成し、変更されていないパッケージをスキップします。
  • CI で自動化する際は、GitHub Actions で changesets/action を使用して、自動的に「Version Packages」PR を作成し、マージ時に公開します。
  • パッケージを連携させる際は、同じバージョンを共有する必要があるパッケージ (CLI + SDK) には linked を使用し、モノレポ全体のバージョン管理には fixed を使用します。
  • リリース前のテストを行う際は、CI テストにはスナップショットリリース (--snapshot preview) を使用し、-next.0 バージョンにはプレリリースモード (changeset pre enter next) を使用します。

例

例 1: モノレポの自動リリースを設定する

ユーザーの要求: 「Turborepo モノレポで、自動バージョン管理と公開のために Changesets を設定してください」

アクション:

  1. @changesets/cli をインストールし、npx changeset init を実行して .changeset/config.json を作成します。
  2. PR リンクと作成者の属性のために @changesets/changelog-github を設定します。
  3. 自動的な「Version Packages」PR 作成のために changesets/action を GitHub Actions に追加します。
  4. 公開されたパッケージに影響を与える PR で changeset ファイルを必須とする CI チェックを設定します。

出力: バージョン PR のマージによってトリガーされる、自動バージョン管理、変更ログ生成、および npm 公開を備えたモノレポ。

例 2: 複数のパッケージにわたる破壊的な変更を連携させる

ユーザーの要求: 「コアパッケージのメジャーバージョン bump と、すべての依存関係のパッチ bump をリリースしてください」

アクション:

  1. npx changeset を実行し、major bump でコアパッケージを選択します。
  2. 変更ログの破壊的な変更の説明を記述します。
  3. npx changeset version を実行します。これにより、コアパッケージが bump され、すべての依存関係がパッチされます。
  4. 生成された変更ログとバージョン bump を確認し、マージします。

出力: コアパッケージのメジャー bump と、すべての依存パッケージの自動パッチ bump を伴う連携されたリリース。

ガイドライン

  • 公開されたパッケージに影響を与えるすべての PR で changesets を必須とし、CI チェックで強制します。
  • 開発者ではなく、ユーザー向けの changeset の説明を記述します。「CSS モジュールをリファクタリングした」ではなく「ボタンのホバー状態を修正した」のように記述します。
  • CLI や SDK のペアなど、同期を維持する必要があるパッケージには linked を使用します。
  • PR のテストにはスナップショットリリースを使用します。CI テストのために 0.0.0-timestamp バージョンを公開するためです。
  • PR リンクと作成者の属性を含めるには、オープンソースプロジェクトに @changesets/changelog-github を使用します。
  • プロジェクト構成として、.changeset/config.json をリポジトリのルートに保持します。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Changesets

Overview

Changesets is a versioning and changelog management tool for JavaScript/TypeScript monorepos. Developers add changeset files describing their changes, then CI consumes them to bump package versions, generate changelogs, and publish to npm with coordinated releases across interdependent packages.

Instructions

  • When adding a change, run npx changeset, select affected packages, choose the semver bump type (patch, minor, major), write a user-facing description, and commit the generated .changeset/xxx.md file with the PR.
  • When releasing versions, run npx changeset version to consume pending changesets, bump package.json versions, update CHANGELOG.md per package, and handle dependency bumps automatically.
  • When publishing, run npx changeset publish to publish changed packages to npm, create git tags, and skip unchanged packages.
  • When automating with CI, use changesets/action in GitHub Actions to automatically create a "Version Packages" PR and publish on merge.
  • When coordinating packages, use linked for packages that must share the same version (CLI + SDK) and fixed for monorepo-wide versioning.
  • When testing pre-releases, use snapshot releases (--snapshot preview) for CI testing or pre-release mode (changeset pre enter next) for -next.0 versions.

Examples

Example 1: Set up automated releases for a monorepo

User request: "Configure Changesets for automated versioning and publishing in my Turborepo monorepo"

Actions:

  1. Install @changesets/cli and run npx changeset init to create .changeset/config.json
  2. Configure @changesets/changelog-github for PR links and author attribution
  3. Add changesets/action to GitHub Actions for automatic "Version Packages" PR creation
  4. Set up CI check that requires a changeset file on PRs affecting published packages

Output: A monorepo with automated versioning, changelog generation, and npm publishing triggered by merging the version PR.

Example 2: Coordinate a breaking change across multiple packages

User request: "Release a major version bump for our core package and patch bumps for all dependents"

Actions:

  1. Run npx changeset and select the core package with major bump
  2. Write a description of the breaking change for the changelog
  3. Run npx changeset version which bumps the core package and patches all dependents
  4. Review the generated changelogs and version bumps, then merge

Output: A coordinated release with a major bump on the core package and automatic patch bumps on all dependent packages.

Guidelines

  • Require changesets on every PR that affects published packages and enforce with a CI check.
  • Write changeset descriptions for users, not developers: "Fixed button hover state" not "Refactored CSS modules."
  • Use linked for packages that must stay in sync, such as CLI and SDK pairs.
  • Use snapshot releases for testing PRs since they publish 0.0.0-timestamp versions for CI testing.
  • Use @changesets/changelog-github for open-source projects to include PR links and author attribution.
  • Keep .changeset/config.json in the repo root as project configuration.