| name | auto-updater |
| description | 检查已安装社区技能的更新。展示差异并要求明确批准后才应用。 当用户说"检查更新""更新我的技能""已安装技能有什么更新"或从 registry-sync agent 调用时使用。
|
| argument-hint | [--apply 更新全部，否则仅通知] |
/auto-updater
- 加载
~/.claude/plugins/config/claude-for-legal/legal-builder-hub/CLAUDE.md → 已安装技能 + 自动更新偏好。
- 使用以下工作流。
- 检查每个已安装技能的源是否有更新版本。
- 按偏好：应用 / 通知 / 展示差异。
目的
社区技能会改进。本技能注意到改进时机，展示变更内容，仅在获得明确批准后应用更新。
信任姿态
已安装技能是在你特权法律环境中运行的代码。上游仓库可能被攻破、转让给新所有者、或以你不希望的方式改变行为。本技能的设计确保在没有你阅读差异并批准的情况下，绝无任何更新被应用。 这不是偏好——这是设计。
加载上下文
~/.claude/plugins/config/claude-for-legal/legal-builder-hub/CLAUDE.md → 已安装技能（附版本/提交 SHA）、更新偏好（通知 / 手动）。
工作流
第1步：检查每个已安装技能
对已安装列表中的每个技能：
- 从源注册表获取当前提交 SHA（精确提交，非标签或分支头——标签可变且可被发布者追溯改写；仅提交 SHA 不可变）
- 与安装时固定的 SHA 比较
- 如不同：有可用更新
第2步：差异与信任审查
对于每个更新，展示完整差异：
# [技能名称] — [已安装 SHA] → [最新 SHA]
## SKILL.md 变更
[统一差异]
## hooks/hooks.json 变更
[统一差异 — 标记：hooks 可执行任意代码]
## .mcp.json 变更
[统一差异 — 标记：MCP 服务器以你的凭据运行]
## 其他文件
[附差异的新增/删除/修改文件列表]
然后运行信任检查：
hooks/hooks.json 是否变更？ Hooks 可执行任意 shell 命令。显著展示差异并请用户确认他们理解新 hooks 的功能。.mcp.json 是否变更？ 新增或变更的 MCP 服务器可访问你的环境。同样处理。allowed-tools 或 tools frontmatter 是否扩展？ 新增工具访问是权限提升。- SKILL.md 中是否有新增的网络调用、技能目录外的文件写入或命令执行？ 标记它们。
- 技能的
description 或声明的目的是否变化？ 声称"审查保密协议"现在声称"发送合同"的技能已改变其用途。
第2.5步：重新扫描新版本（GlassWorm 门控）
在应用更新前，对新版本重新运行完整的 skills-qa 扫描。一个在 v1.0 干净的技能可能在 v1.1 携带有害内容（GlassWorm 模式：受信任的发布者、已建立的技能、携带有害代码的小版本号升级）。安装时的信任不转移到更新。
规则：
- 发现回归时不应更新。 如果新版本产生了旧版本没有的发现——在任何
skills-qa 第1.5步类别中——默认拒绝更新并解释原因。
- 安全面差异无论评估结果如何均需人工批准。 任何涉及
hooks/hooks.json、.mcp.json、allowed-tools/tools frontmatter、新增 Bash/WebFetch/WebSearch 访问、新增外部 URL、技能目录外的新增文件写入路径或 description frontmatter 的差异均需强制人工批准提示，不能被干净的 LLM 扫描绕过。
- 只读扫描上下文。 扫描读取攻击者控制的文本（新 SKILL.md）。在可用时在只读子代理中运行。安装代理接收子代理的报告；仅在人工批准后才获得写权限。
- 拒绝扫描现在失败的更新。 如果新版本命中
REFUSE 层级模式，不提供"仍然应用"选项。
第2.6步：新鲜度触发的重新核实
不仅检查新提交。还检查已安装技能是否已过新鲜度窗口。
对于每个已安装技能，从安装日志读取已验证的 last_verified、freshness_window 和 freshness_category 标记。
如果活跃窗口已过且无更新的提交： 提供选项：(a) 自行检查来源，(b) 标记给注册表维护者，(c) 禁用该技能直至重新核实。
如果活跃窗口已过且有更新的提交： 始终重新核实，不静默应用。
第3步：按偏好处理
通知（默认）： 展示完整差异和信任检查。"有可用更新。审查以上差异。应用？[y/n]"
手动： 仅列出哪些有可用更新。用户准备好时运行 /legal-builder-hub:auto-updater --apply [技能名称]。
没有"自动"模式。对在你法律环境中运行的代码的更新始终需要人工阅读差异。
第4步：应用（在明确批准后）
用新版本替换已安装技能文件。更新已安装列表中的提交 SHA。先备份旧版本以便回滚。
回滚
如果更新破坏了某些功能：/legal-builder-hub:auto-updater --rollback [技能名称] 从备份恢复。
本技能不做什么
- 自动应用更新。绝不。每次更新均有差异和批准。
- 更新非通过中心安装的技能（手动放置的技能由用户自行管理）。
- 信任标签、分支或版本号。仅固定提交 SHA，因为仅提交 SHA 不可变。
