update

更新

路径：${CLAUDE_SKILL_DIR} 表示包含此 SKILL.md 的文件夹，${CLAUDE_PLUGIN_ROOT} 表示它上两级的插件文件夹。

所有问题都放在问题框中：AskUserQuestion 工具（提供 2–4 个选项，推荐选项放在首位）。只有在不具备该工具的 Agent 中，才用文本提出编号问题。

U="${CLAUDE_SKILL_DIR}/scripts/update.py"。在 Mac 和 Linux 上用 python3 运行，在 Windows 上用 py 运行。 如果用户的克隆仓库不在 Claude Code 运行所在的文件夹中，请添加 --repo <folder>。

绝不推送、绝不强制推送、绝不删除分支、绝不暂存或重置用户尚未提交的工作。只有用户提出要求时，才推送到他们的 fork。

1. 确认安装方式

python3 "$U" where

• marketplace：运行 python3 "$U" market。它会运行 claude plugin marketplace update nextwork，然后自行运行 claude plugin update，更新 ai-editor@nextwork 和 creator-teardown@nextwork。随后告诉他们输入 /reload-plugins。如果失败，则告知他们程序打印出的内容。他们的样式、技能和设置都保存在 他们自己的文件夹中，不会丢失（docs/customise.md）。到此为止。
• plain clone：告知他们程序打印出的三个 fork 步骤。到此为止。
• fork，但在克隆仓库之外运行：询问其克隆仓库所在的文件夹，然后使用 --repo。
• fork，缺少 upstream：询问“要将 nextwork-projects/ai-video-editor-cooked 添加为 upstream，以便从中获取更新吗？”（是，添加（推荐） / 否）。如果选择是：python3 "$U" add-upstream。

2. 检查

python3 "$U" check

用几行告诉用户：有多少个新提交、这些提交带来的 CHANGELOG 内容（用通俗的语言说明他们会注意到的变更），以及此次更新也会修改他们的哪些文件。然后询问 立即更新（推荐） / 暂不更新。

3. 合并

python3 "$U" merge

• 退出码 2，存在未提交的更改：展示程序打印出的内容。询问 将它们作为“我的更改”提交 （推荐） / 我会自行处理。只有用户确认后才提交，然后重新合并。绝不暂存。
• 退出码 0：进入第 4 步。
• 退出码 3，存在冲突：逐个文件解决。对于每个文件，保留用户的更改并采用上游的修复，然后用一行说明处理方式（“captions.tsx：保留了你的字体，采用了新的安全区修复”）。如果确实发生冲突且需要由用户决定（双方将同一设置改成了不同的值），请在问题框中询问，并将双方方案分别作为选项，用户的方案放在前面。然后对每个文件运行 git add，再运行 git commit --no-edit。

备份分支名为 before-update-<date>；告知用户一次其名称。

4. 验证

python3 "$U" verify

它会运行 tests/check_plugins.py 和 tests/demos.sh。通过：告诉用户输入 /reload-plugins （如果他们从 GitHub 上的 fork 安装，还要告诉他们：如有需要，推送到该 fork 并运行 /plugin marketplace update nextwork 即可将更新应用到那里）。失败：展示未通过的检查，并询问 修复它们（推荐） / 回到更新前。回退：

python3 "$U" rollback

它会中止尚未完成的合并，或将分支移回备份分支。不会删除任何分支。