关于 upgrading-emdash
用于规划 EmDash 升级的命令行工具，会解析 npm 发布标签、更新直接依赖并刷新技能，随后生成项目专属升级工单。它不修改应用代码、执行数据库迁移或部署。
主要功能
- 01解析 npm 发布标签
- 02更新直接 EmDash 依赖
- 03刷新 EmDash 技能
- 04生成包含变更与迁移信息的工单
- 05支持 dry-run 和 JSON 输出
适用场景
- 01检查升级前将涉及的改动
- 02为 beta 或 next 发布标签准备升级
- 03按工单评估项目所需代码与配置变更
- 04在升级前核对迁移和备份要求
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/upgrading-emdash确认已加载。
详细介绍
升级 EmDash
使用 upgrade-emdash 解析所选 npm 发布标签，更新所有直接依赖的 EmDash 包，刷新 EmDash 技能，并创建项目专属的升级任务单。此更新器不会修改应用代码、应用数据库迁移或进行部署。
准备升级任务单
从项目根目录运行：
npx upgrade-emdash@latest --dry-run
npx upgrade-emdash@latest
使用 --to <tag> 指定其他 npm dist-tag，例如 next 或 beta。--to 不接受版本号。在非交互环境中使用 --yes 接受更新器提示，使用 --json 生成机器可读的试运行结果；如果项目根目录在其他位置，请使用 --cwd <path>。
更新器会写入 .emdash/UPGRADE.md。命令完成后，请阅读该文件。文件中包含本项目直接依赖的包所涉及的全部已编写变更日志条目，已移除自动生成的依赖升级条目；还包含安装后发现的准确核心迁移差异。
完成升级
- 检查现有项目及其未提交的更改。保留无关工作。
- 对照项目评估
.emdash/UPGRADE.md中的每条发布条目。应用所需的源代码和配置更改。如果项目未使用受影响的功能范围，请勿采用新功能。 - 运行仓库相关的格式检查、测试、类型检查和构建命令。
- 运行升级任务单中的迁移状态命令，并报告目标数据库和待处理迁移。
- 如果升级任务单列出了新增的核心迁移、状态命令报告了更早的待处理迁移，或发布条目要求项目执行会更改数据的操作，请在启动或部署升级后的应用前，按照升级任务单中的备份流程操作。
- 除非用户在请求中明确包含相应操作，否则在对数据库应用迁移、进行部署或执行任何其他远程更改前，先征求用户同意。
- 在获得授权并完成迁移和部署后，运行迁移检查，并验证受影响的网站路径。
核心迁移只能向前执行。如果软件包更新没有新增或待处理的迁移，则无需创建专门针对升级的恢复点。在获授权执行会更改数据库的操作前，必须准备好可还原的数据库备份（使用备份与恢复创建）、单独的媒体备份、相关加密密钥，以及用于迁移和部署的同一构建产物。JSON 备份不属于恢复点。回滚时，应一并还原匹配的数据库和应用构建产物，而不是运行迁移的 down() 函数或删除迁移记录。
评论
支持 Markdown