SuperAPI AI 工具集

setup-code-maintenance-bot

部署与运维

查看项目

更新于 10-16 22:42

技能介绍

该技能属于 Paperclip 自动化体系,用于把用户的代码维护意图转化为可运行的 Paperclip 例行任务(routine),由命名的智能体执行,并产出可检查的拉取请求(PR)。维护技能本身提供领域判断能力,例如测试审计、文档维护、依赖维护、重构或其他选定任务。

用途

当用户希望建立一个持续运行(例如每晚)的代码维护机器人时使用。它不是一个代码维护技能本身,而是负责“搭建”这一自动化:配置实例、智能体、仓库、技能、触发时间、限额和 PR 行为。

主要能力

  • 将维护意图转化为带命名智能体的可运行 Paperclip 例行任务。
  • 支持复用现有智能体或创建新智能体,并为其解析名称、执行框架/适配器、提供商与模型、AI 连接/账户、执行环境、汇报关系和预算。
  • 支持指定仓库、目标分支、执行工作区/环境。
  • 支持定时触发(本地时间 + IANA 时区)、Webhook 事件/来源或手动/API 触发。
  • 设置每次运行的时间/成本上限、每次运行最大 PR 数、未关闭 PR 上限。
  • 配置 PR 目标与审查人/负责人、草稿或就绪状态、所需验证。
  • 支持监控并修订 PR 直至检查通过,并为受阻工作指定负责人和延续路径。
  • 支持仅起草指令或设置计划而不实际配置。

使用方式

设置流程分为五步:

  1. 确定目标与智能体:先选择已核实可点击的 Paperclip 实例 URL、解析公司、列出可访问的合适智能体并让用户选择复用或新建;新建时需解析其各项配置。可参考 references/paperclip-api.md 了解认证、发现、连接绑定、招聘与配置调用;若 API 不可用且有浏览器访问,可通过 Paperclip UI 完成同样设置,并注意调和部分完成的 API 设置以避免重复资源。
  2. 确定维护契约:仅询问缺失选项,分组提问;先发现实际项目与技能再提供。需解析仓库(项目、仓库 URL、目标分支、执行工作区/环境)、工作(维护目标、确切技能/来源、包含与排除范围)、触发(带本地时间与 IANA 时区的定时器、Webhook 事件/来源或手动/API)、限额(每次运行时间/成本上限、每次最大 PR 数、未关闭 PR 上限)、投递(PR 目标与审查人/负责人、草稿或就绪、所需验证)和生命周期(监控修订 PR 直至检查通过、受阻工作的负责人与延续路径)。技能需解析到执行环境能实际读取的来源,并记录所选来源/版本策略。
  3. 准备配置:使用 references/run-instructions.md 撰写完整例行任务描述,避免重复现有智能体与例行任务,展示包含实例链接、智能体选择、连接/框架、仓库、技能、触发/时区、限额、PR 行为与就绪缺口的紧凑摘要。
  4. 配置、验证与激活:按顺序获取授权访问、配置/复用智能体、使技能可用、创建暂停的例行任务、添加禁用的触发并读回所有内容;记录返回的 ID,从中恢复部分设置。验证智能体可运行且能在实际执行环境中使用所选连接、仓库、技能与 PR 凭证;在招聘审批、凭证、工作区或技能未解决时保持例行任务暂停。仅在就绪与调度授权确立后启用触发并激活例行任务。
  5. 交接:返回实例、智能体、例行任务与项目的链接,所选技能,触发与时区,激活/暂停状态,限额与 PR 策略,就绪证据与剩余缺口;若已试运行,链接运行问题与结果 PR 或无变更结果;说明如何暂停例行任务及由谁处理后续。

适用场景

  • 夜间维护机器人。
  • 自动测试审计、文档维护、依赖维护、重构等定期代码维护任务。
  • 需要自动化产出 PR 并在人工审查下合并的维护流程。

限制

  • 若仅被要求起草指令或设置计划,只产出该产物并停止,不进行配置或运行;设置机器人期间不执行维护;即时试运行与排期是两个独立选择。
  • “每晚”仍需明确时间和时区,不自行推断。
  • 一份合理起始提议是每次运行一个连贯 PR、设定时间盒、不自动合并、达到约定的未关闭 PR 上限后不再新增工作,但这些是提议而非固定产品限制。
  • 聊天检出中的文件不能证明远程 worker 中存在该技能,需验证目标分支路径或安装并分配公司技能。
  • 不得用松散相似的任务静默替代不可用的请求技能。
  • 适配器探测成功并不能证明 Git push/PR 权限。
  • 不得更改共享项目默认值来让机器人工作。
  • 不得将草稿、待招聘或暂停的例行任务报告为正在运行。
  • 资料未提供:具体收费或价格信息、具体的模型/提供商兼容列表、具体的 API 端点或命令细节(仅在引用文件中描述)。