用途：为 Trellis 的新补丁、beta、rc 或次版本发布创建迁移清单，并生成对应的 docs-site 更新日志。参数为目标版本号（如 0.5.15 或 0.6.0-beta.14），省略时需询问用户。
主要能力：通过 git tag 与 git log 定位上一发布标签并收集变更；按 feat、fix、refactor、chore 分类提交，撰写一行式 changelog；确定 manifest 的 breaking、recommendMigrate、migrations、migrationGuide、aiInstructions、notes 等字段；生成中英 1:1 对应的 docs-site changelog MDX 并更新 docs.json 与导航链接；执行发布前本地校验。
使用方式：用 git tag --sort=-v:refname | head -5 找上一标签，用 git log <last-release-tag>..HEAD --oneline 收集提交，用 git diff 阅读相关 diff。通过 stdin 管道把 JSON 交给 node packages/cli/scripts/create-manifest.js 生成清单。发布前运行 check-docs-changelog.js、release-preflight.js 的 check-versions、verify-packed-cli、publish-plan，以及 pnpm lint、pnpm typecheck、pnpm test。发布走 CI：pnpm release、pnpm release:beta、pnpm release:rc、pnpm release:promote。
适用场景：Trellis 仓库的版本发布准备，尤其是含破坏性变更或重命名/删除迁移的版本。
限制：官方 npm 发布仅限 CI，禁止本地 npm publish 或 pnpm publish 补救；两个包 @mindfoldhq/trellis 与 @mindfoldhq/trellis-core 必须版本与 dist-tag 一致；breaking 且 recommendMigrate 为 true 时缺少 migrationGuide 会导致升级体验损坏；破坏性发布需在临时目录做端到端迁移演练。