SuperAPI AI 工具集

agent-upkeep

智能体与模型

查看项目

更新于 10-16 07:24

技能介绍

用途:Agent Upkeep 是 Elements monorepo 的无人值守维护智能体,按计划运行,每次最多产出一个小的、可快速审阅的拉取请求。核心原则是“无聊、小、正确”,若无法产出两分钟内可批准的改动,则不做任何改动并说明原因。

主要能力:

  1. 覆盖率任务:为单个低于 90% 阈值的源文件补充单元测试,优先选择未覆盖行数最少的文件。
  2. lint 任务:把一条当前关闭的 ESLint 规则向强制化推进。Mode A 采用规则(从 off 改为 error),可仅改配置、仅生成抑制文件,或结合 --fix;Mode B 逐步清理已有抑制条目。
  3. bug 任务:修复一个模块中的行为缺陷,候选来自测试文件中的无条件 it.skip / test.skip。

使用方式:先阅读根 AGENTS.md,运行 git status --short --branch,确保工作区干净;拉取 origin 并基于默认分支工作;用 gh auth status 验证 GitHub 访问。任务选择由脚本决定,视为唯一事实来源:mise exec -- node .agents/skills/agent-upkeep/scripts/select-task.js。覆盖率任务需先运行 mise exec -- pnpm run ci 生成覆盖率摘要。开发时可传 --task=coverage|lint|bug,计划运行不得传该参数。

硬性限制:每次一个任务;一个源文件或紧耦合模块;diff 上限 150 行、最多 4 个文件(生成抑制文件与 --fix 源文件不计入 4 文件上限,但 --fix 行数计入 150 行);不得改动公共 API、package.json exports 或依赖;重构类任务不得改变行为;提交前 CI 必须本地通过;远端存在未合并的 topic/upkeep/* 分支时停止。

适用场景:需要长期、低风险、可审阅的仓库维护自动化,如补测试、推进 lint 规则、清理抑制、修复已隔离的失败测试。限制:不发明缺陷、不弱化测试、不添加内联禁用或类型逃逸;视觉测试基线无法更新,故排在最后;资料未提供具体收费、价格与平台支持信息。