name: speckit-updaterdescription: SpecKit Safe Updaterisk: criticalsource: communitySpecKit 安全更新此技能为 GitHub SpecKit 安装提供安全更新能力在应用模板更新的同时保留自定义内容。安装在添加任何市场或手动克隆之前请检查确切的插件版本和每个捆绑文件报告脚本以及网络或文件系统行为并请求用户的明确批准。不要将移动中的分支直接安装到活跃的智能体目录中。何时使用你需要更新或安装 SpecKit 模板同时保留项目自定义内容。你想要围绕更新、回滚或特定版本的 SpecKit 操作有一个安全的批准流程。任务是以对话方式操作 SpecKit 更新器而不是盲目运行原始命令。当此技能被调用时要做什么当用户调用/speckit-updater时你应该运行更新编排脚本不带任何标志对话模式pwsh-NoProfile-Fileskill_path/scripts/update-wrapper.ps1解析输出中的标记[PROMPT_FOR_APPROVAL]- 更新场景已有 SpecKit 安装[PROMPT_FOR_INSTALL]- 全新安装场景没有 .specify/ 目录对于更新找到[PROMPT_FOR_APPROVAL]标记展示 Markdown 摘要显示当前版本 vs. 可用版本要更新/添加/删除的文件检测到的冲突如果有保留的文件已自定义备份位置自定义命令请求用户批准以继续更新如果批准使用-Proceed标志重新运行如果拒绝告知用户更新已取消对于全新安装找到[PROMPT_FOR_INSTALL]标记向用户提供自然的安装邀请例如“SpecKit 目前未安装在此项目中。要我安装它吗”“我可以为你安装最新的 SpecKit 模板。这将创建 .specify/ 目录结构并从 GitHub 下载模板。”不要向用户提及-Proceed标志这是实现细节如果用户批准说好、“继续”、安装它等使用-Proceed标志重新运行如果用户拒绝告知他们安装已取消通过使用-Proceed标志重新运行来执行已批准的操作pwsh-NoProfile-Fileskill_path/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等待批准不是错误与更新流程一致两者都使用对话式批准工作流流程验证前提条件已安装 Git、干净的 Git 状态、写入权限加载或创建清单.specify/manifest.json从 GitHub Releases API 获取目标版本比较文件哈希以识别自定义内容创建带时间戳的备份应用选择性更新保留自定义文件对冲突打开 VSCode 合并编辑器流程 A一次一个自动调用 /speckit.constitution 进行宪法更新用新版本更新清单管理备份保留保留最近 5 个当你调用此命令时我将执行 update-orchestrator.ps1 脚本解析输出中的标记更新用[PROMPT_FOR_APPROVAL]全新安装用[PROMPT_FOR_INSTALL]对于更新展示提议更改的 Markdown 摘要对于安装自然地询问你是否要安装 SpecKit不提及-Proceed标志通过聊天对话等待你的批准批准后自动使用-Proceed标志重新调用以执行一次一个文件地指导你解决冲突仅更新按需打开 VSCode diff/merge 工具仅更新用详细摘要报告结果对话式工作流此技能使用两步批准流程第 1 步输出摘要 → 脚本退出 → 等待批准第 2 步批准后Claude 使用-Proceed重新调用 → 应用更新要求已安装 Git 且在 PATH 中互联网连接用于从 GitHub 获取更新对 .specify/ 和 .claude/ 目录的写入权限干净或已暂存的 Git 工作目录脚本位于{skill_path}/scripts/update-wrapper.ps1入口点和{skill_path}/scripts/update-orchestrator.ps1主要逻辑入口点命令pwsh-NoProfile-Command {skill_path}/scripts/update-wrapper.ps1 [parameters]注意通过包装脚本同时支持 PowerShell 风格-CheckOnly和 Linux 风格--check-only标志。功能自定义内容保留使用规范化文件哈希自动检测并保留用户自定义内容智能冲突解决一次一个地指导解决冲突有 4 个选项合并编辑器、保留我的、使用新的、跳过版本跟踪维护带文件哈希、版本信息和备份历史的.specify/manifest.json自动备份在.specify/backups/中创建带时间戳的备份并自动管理保留快速失败并回滚任何错误时自动回滚恢复到更新前状态试运行模式--check-only显示将更改的内容而不应用更新宪法集成当宪法模板有更新时通知运行/speckit.constitution自定义命令安全用户创建的命令绝不会被覆盖即使使用--force架构模块HashUtils规范化哈希处理行尾、尾随空格、BOMVSCodeIntegration上下文检测、Quick Pick、diff/merge 编辑器集成GitHubApiClientGitHub Releases API 交互未认证60 次请求/小时ManifestManager带缓存的清单 CRUD 操作BackupManager备份创建、恢复和保留管理ConflictDetector文件状态分析和冲突检测工作流前提条件验证关键检查必须通过警告允许继续清单加载/创建安全默认如果没有清单假设所有文件都已自定义GitHub API 查询目标版本文件状态分析6 种操作添加/移除/合并/保留/更新/跳过带更改预览的用户确认备份创建带时间戳排除备份目录选择性文件更新快速失败并自动回滚冲突解决流程 A一次一个VSCode 合并编辑器清单更新版本、文件哈希、自定义标志备份清理保留最近 5 个需要确认显示详细摘要退出码代码含义0成功1一般错误2前提条件未满足3网络/API 错误4Git 错误5用户取消6需要回滚自动限制仅当任务明确符合上述范围时使用此技能。不要将输出视为特定环境验证、测试或专家审查的替代品。如果缺少必需的输入、权限、安全边界或成功标准请停下来询问澄清。