技能:工作室自动更新 (/usds-update)
执行代理: delivery-manager (交付经理)
概述 (Summary)
此技能用于将当前项目的 USDS 基础设施(代理、技能、规则)更新至 GitHub 仓库的最新版本。它会自动备份当前配置并拉取新代码。
更新工作流
- 版本检查:
delivery-manager展示本地版本与远程最新版本的差异。 - 变更摘要: 列出新版本中的主要改进点。
- 用户确认: 提示用户确认是否覆盖
.claude/下的核心组件(CLAUDE.local.md等本地文件不会被覆盖)。 - 执行更新:
- 在 Windows 上,它会提示用户运行:
irm https://raw.githubusercontent.com/wxxzy/Claude-Code-Software-Studios/master/scripts/install-usds.ps1 | iex - 在 macOS/Linux 上,它会提示用户运行:
curl -fsSL https://raw.githubusercontent.com/wxxzy/Claude-Code-Software-Studios/master/scripts/install-usds.sh | bash - 管道模式需显式传参:加
-s -- --profile <名> --force(sh)或用 scriptblock 包装传-Profile <名> -Force(ps1)
- 在 Windows 上,它会提示用户运行:
- 完成: 提示用户重启会话以加载新技能。
升级迁移说明
安装器会自动清理重命名残留:从 v2.0 升级到 v2.1 时,已被前缀化取代的旧命令目录
(start、review、discovery 等 20 个,见 docs/arch/ADR-002)会在安装新文件后删除,
避免斜杠菜单新旧命令并存。该清理只针对 USDS 保留名,不影响用户自装技能。
新旧的完整对照表在 CLAUDE.md 的 "v2.1 命令重命名对照" 一节。
成功门控 (Success Gate)
.claude/VERSION文件已更新至最新版本号。- 新的技能指令出现在
/列表中。
输出约束 (Output Budget)
[强制] 完成后,返回主上下文只输出:
工作室已更新。
- 版本:[旧版本] → [新版本]
- 请重启会话以加载新配置。
更新已跳过或失败时:更新跳过 — 当前已是最新版本 [版本号]