用途:根据当前会话中的代码改动创建 Changesets 发布说明,并在用户要求时应用待处理的 changeset,完成版本提升。
主要能力:检测工作区改动;将改动文件映射到受影响的包(monorepo 按最近的包根目录,单包仓库用根包名);给出 patch、minor、major 的语义化版本提升建议及理由;在 .changeset/ 中创建带 frontmatter 包版本提升的 markdown changeset 文件;按需执行 changeset version 应用待处理 changeset。
必要用法:前置条件是仓库使用 @changesets/cli(或有等价 changeset 脚本)、.changeset/ 存在或可创建、用户明确要求创建和/或应用。工作流先查看仓库状态(git status --short、git diff --name-only)并从根 package.json 识别包管理器与脚本,再判定各包版本提升级别,最后创建文件。应用时按项目既有脚本优先,否则用包管理器执行,例如:pnpm changeset version、npm run changeset version、bunx changeset version。
限制与安全规则:未经用户要求不得应用 changeset;不得编造包名,只用 package.json 中找到的工作区包名;除仓库约定外排除私有/内部包;提升类型不明确时默认 patch 并说明原因;不包含无关文件或推测性发布说明。输出包含受影响包、提升决策、changeset 文件、是否应用及所用命令、备注(歧义或假设)。未提供价格、平台限制与效果数据。