技能介绍

为什么需要声明式更新

当仓库中存在多个依赖清单（如 package.json、requirements.txt、go.mod）或配置文件时，逐个手工更新版本号容易遗漏、产生不一致的变更，且难以追溯「这次改了哪些依赖、为什么改」。同时，单个生态系统的自动升级机器人（如 Dependabot）通常只能覆盖一种依赖类型，无法在一次运行中统一处理混合技术栈、跨仓库的配置漂移，也无法插入团队自定义的验证逻辑。

技能如何工作

该技能基于 Updatecli 的声明式策略模型，核心流程分为三步：

检测上游版本：通过 Updatecli 的 source 定义从注册表、Git 标签或自定义 URL 获取最新版本，支持语义化版本过滤与分支匹配。
验证条件：使用 condition 检查当前仓库状态，例如确认依赖尚未升级、配置文件格式有效、或变更未超出允许范围。
生成可审查的变更：通过 target 定位并修改 versioned files（如清单文件中的版本号），并触发 Pull Request 或提交，使每次更新都具备完整上下文和可审计的 diff。

整个流程由单个 YAML 策略文件驱动，一次运行即可覆盖多依赖、多文件的更新需求，避免依赖碎片化的机器人链。

适用边界与注意点

前置条件：需要本地或 CI 环境已安装 Updatecli 二进制，提供有效的 YAML 策略文件，并确保对目标仓库或文件的读写权限。
验证与审查不可跳过：该技能自动生成的更新仍需通过团队评审流程确认。对于关键基础设施仓库，建议先在测试环境运行，并检查生成的 PR 是否包含非预期变更。
上游来源需自行审查：SKILL.md 中未提供自动提取的安装或使用说明。运行前请查阅上游项目文档，确认策略文件来源可靠，特别是在处理生产环境敏感工作流时。
不是替代方案：该技能适合周期性、批量式的依赖与配置更新，不适合一次性手工修改或需要交互式决策的升级场景。