用途:作为 Elements monorepo 的依赖维护智能体,按夜间计划无人值守运行,每次运行最多产生一个小型拉取请求,便于审查者识别被升级的依赖、受影响项目及验证证据。若无法隔离并验证单个升级,则不提交任何更改并报告原因。
主要能力与约束:每次只选择一个更新单元(一个直接依赖或一个有证据支持的同步家族);不做主版本升级,低于 1.0.0 的依赖只更新补丁版本;跳过预发布、已弃用、Git 来源、别名和工作区依赖;不直接更新传递依赖;除有证据的家族外,不把 npm 包、GitHub Actions、Node.js、pnpm 或其他 mise 工具合并到同一拉取请求;保留依赖分区、catalog 引用、版本范围风格、overrides、patches 和构建权限;不改源码、测试、快照、生成的可视基线、公共 API 或无关配置;仅更新 actions/* 命名空间的 GitHub Actions;本地完整 CI 必须通过后才开 PR;停止运行也算成功。
使用方式:先读取根 AGENTS.md 并运行 git status --short --branch,要求工作区干净;获取 origin 并基于默认分支工作,不直接推送默认分支;用 gh auth status 验证 GitHub 访问。从仓库根运行收集器:mise exec -- node .agents/skills/agent-dependencies/scripts/select-update.js。收集器负责发现候选、评估边界、报告阻塞项并推荐提交类型与范围。按补丁优先于次要、单项目范围优先于通用工具、单依赖单清单优先于更大单元、包名作为稳定平局规则的顺序审查候选。编辑后从根安装并生成通知:CI=1 mise exec -- pnpm install --no-frozen-lockfile 与 mise exec -- pnpm run notice。验证时先读 projects/<name>/DEVELOPMENT.md,项目范围更新先在该项目目录运行 mise exec -- pnpm run ci;随后从根运行 mise exec -- node .agents/skills/agent-dependencies/scripts/verify-update.js --type=<fix|chore> --scope=<scope>、CI=1 mise exec -- pnpm install --frozen-lockfile、mise exec -- pnpm run ci 和 git diff --check。分支命名为 topic/dependencies/<scope>/<dependency-slug>,使用小写主题、不超过 100 字符并带 Signed-off-by 的约定式提交,推送后开 ready-for-review 的 PR。
适用场景:适合夜间或无人值守的依赖与工具链维护,尤其是需要严格隔离、可审查、可验证的单次升级。
限制:不处理需要迁移或兼容性修复的升级;不更新快照或放宽检查;不覆盖验证器失败;若收集器返回 collected: false、无候选通过审查、家族无法对齐、声明跨多个提交范围、需要源码或测试改动、生成文件涉及其他项目范围、项目无有效提交范围或必需验证未通过,则不开 PR。具体价格、平台支持等信息暂未提供。