---

name: speckit-updater description: SpecKit 安全更新 risk: unknown source: community

SpecKit 安全更新

此技能为 GitHub SpecKit 安装提供安全更新功能，在应用模板更新的同时保留自定义配置。

安装：可通过插件安装（/plugin marketplace add NotMyself/claude-plugins 然后 /plugin install speckit-updater）或手动 Git 克隆。详见 README.md。

何时使用

• 你需要更新或安装 SpecKit 模板，同时保留项目自定义配置。
• 你需要围绕更新、回滚或特定版本的 SpecKit 操作进行安全审批流程。
• 任务是以对话方式操作 SpecKit 更新器，而不是盲目运行原始命令。

调用此技能时的操作

当用户调用 /speckit-updater 时，你应该：

1. 运行更新编排脚本，不带任何标志（对话模式）：

   pwsh -NoProfile -Command "& 'C:\Users\bobby\.claude\skills\speckit-updater\scripts\update-wrapper.ps1'"
   

2. 解析输出中的标记：

   • [PROMPT_FOR_APPROVAL] - 更新场景（已有 SpecKit 安装）
   • [PROMPT_FOR_INSTALL] - 全新安装场景（无 .specify/ 目录）

3. 对于更新（找到 [PROMPT_FOR_APPROVAL] 标记）：

   • 展示 Markdown 摘要，显示：
     • 当前版本与可用版本对比
     • 要更新/添加/删除的文件
     • 检测到的冲突（如有）
     • 保留的文件（已自定义）
     • 备份位置
     • 自定义命令
   • 向用户请求批准以继续更新
   • 如果批准，使用 -Proceed 标志重新运行
   • 如果拒绝，通知用户更新已取消

4. 对于全新安装（找到 [PROMPT_FOR_INSTALL] 标记）：

   • 向用户展示自然的安装提议，例如：
     • "此项目当前未安装 SpecKit。是否需要我为你安装？"
     • "我可以为你安装最新的 SpecKit 模板。这将创建 .specify/ 目录结构并从 GitHub 下载模板。"
   • 不要向用户提及 -Proceed 标志（这是实现细节）
   • 如果用户同意（说"是"、"继续"、"安装"等），使用 -Proceed 标志重新运行
   • 如果用户拒绝，通知他们安装已取消

5. 执行已批准的操作，使用 -Proceed 标志重新运行：

   pwsh -NoProfile -Command "& 'C:\Users\bobby\.claude\skills\speckit-updater\scripts\update-wrapper.ps1' -Proceed"
   

特殊情况：

• 如果用户请求 -CheckOnly：使用该标志运行并显示报告
• 如果用户请求 -Rollback：使用该标志运行并确认恢复
• 如果用户请求特定 -Version：包含该参数

命令

/speckit-updater

更新 SpecKit 模板、命令和脚本，同时保留自定义配置。

用法：

• /speckit-updater - 带对话审批工作流的交互式更新/安装（推荐用于 Claude Code）
• /speckit-updater -Proceed - 用户确认后继续更新/安装（Claude 在用户确认后使用）
• /speckit-updater -CheckOnly - 检查更新但不应用
• /speckit-updater -Version v0.0.72 - 更新到特定版本
• /speckit-updater -Force - 强制覆盖 SpecKit 文件（保留自定义命令）
• /speckit-updater -Rollback - 从之前的备份恢复
• /speckit-updater -Auto - 已弃用：请使用对话工作流代替（显示警告，映射到 -Proceed）

全新安装（无 .specify/ 目录）：

• 首次调用显示带 [PROMPT_FOR_INSTALL] 标记的安装提议
• Claude Code 向用户展示自然问题（例如"是否需要我安装 SpecKit？"）
• 用户通过对话回复批准（例如"是"、"继续"、"安装"）
• Claude 自动使用 -Proceed 标志重新调用（对用户隐藏的实现细节）
• 脚本创建 .specify/ 结构，下载模板，创建清单
• 全程退出码为 0（等待批准不是错误）
• 与更新流程一致：两者都使用对话审批工作流

流程：

1. 验证先决条件（已安装 Git、干净的 Git 状态、写入权限）
2. 加载或创建清单（.specify/manifest.json）
3. 从 GitHub Releases API 获取目标版本
4. 比较文件哈希以识别自定义内容
5. 创建带时间戳的备份
6. 应用选择性更新，保留已自定义的文件
7. 为冲突打开 VSCode 合并编辑器（流程 A：逐个处理）
8. 自动调用 /speckit.constitution 进行宪法更新
9. 使用新版本更新清单
10. 管理备份保留（保留最近 5 个）