SuperAPI AI 工具集

maintainer

部署与运维

查看项目

更新于 10-25 02:36

技能介绍

Maintainer 是面向 udecode/plate 仓库的公开队列维护协调技能,用于处理 Plate/Slate 的 issue、PR、安全扫描以及日常仓库维护。它运行在本地 Claude Code 或 Codex 的 maintainer checkout 会话中,不依赖托管 API 机器人、云 worker 或后台守护进程,也不会在没有明确授权的情况下修改 GitHub。

用途与定位: 该技能负责判断一个事项的匹配度、优先级、路由、权限与证明,并在没有更合适执行者时进行协调。它不默认成为执行所有者,也不复制执行者的修复方法。维护运行的目标是:事项被路由、被证明,或在其权限边界处停止。

主要模式:

  • issue-draft <视频或文本>:从视频或文本起草 Plate Beta issue,包含精确复现与媒体材料,仅在用户要求时发布。
  • slate-issue <issue>:区分纯 Slate 复现与 Plate 特有行为。纯 Slate 缺陷按 Slate Boundary 归上游处理,不应隐藏在 Plate 胶水层中。
  • queue:广泛扫描,包括“queue”“所有 issue”“所有 PR”或仓库维护。
  • issues:扫描 issue 队列,使用实时 gh 获取当前状态;gitcrawl 仅用于归档优先的重复/邻近发现。
  • prs:扫描 PR 队列,在建议评审、合并、关闭或修改前读取 PR 正文、文件、评审、评论、检查、作者、更新时间、关联 issue 与当前分支状态。
  • security:处理安全热修复机制,版本化维护文档不得保存私有 advisory 细节。
  • <issue-url|pr-url>:先读取具体事项,再按默认归属分类路由。

队列扫描方式: 刷新 docs/maintainer/queue.md,使用以下命令生成快照: node .agents/rules/maintainer/scripts/queue-snapshot.mjs
--repo udecode/plate
--limit 20
--out docs/maintainer/queue.md
--json .tmp/maintainer/queue-snapshot.json 若 gh 认证或网络受阻,记录阻塞并使用上一次账本作为过期上下文。扫描最小有效切片顺序为:安全与 advisory、需要评审/CI/合并关注的 PR、需要分诊的 issue、用户可见的陈旧 bug,最后是文档或安装配置损坏。

路由规则(摘要):

  • 单个公开 Slate 底层问题:maintainer slate-issue。
  • 单个公开 Plate 行为 bug 或回归:maintainer 协调,通过 pstack 的 Bug fix playbook 运行本地修复包。
  • Plate/Slate 性能回归:maintainer 协调并委托给 benchmark。
  • 本地 Plate 或 Slate 行为 bug 且不涉及公开变更:pstack 的 Bug fix playbook。
  • Plate 公开调用形态分叉:best-api,必要时进入 Plan playbook。
  • 已应用 PR/分支/当前树关闭:Babysit playbook。
  • 内部性能/基准缺口:Perf issue playbook 配合 benchmark。
  • 内部质量/浏览器/API 缺口:pstack poteto-mode,无人值守时作为 Autonomous run。
  • 跨包架构/可测试性/重构候选:Refactoring playbook,然后 Plan playbook。
  • Plate 框架/插件/组件/文档:Plan playbook、plate-plugins、plate-ui 或 Plate Docs。
  • 安全/advisory:maintainer security。
  • 他人 PR 评审:Babysit playbook 的 review-only 面板。
  • PR 评审反馈:Babysit playbook。
  • 外部语料/issue 账本:issue-harvester。
  • 不明确的先前工作:research。

证明与状态门禁: 没有公开复现、证明、风险、所有者面、当前阻塞与下一步的事项不算 agent-ready,需要请求最小的缺失公开证据或保持 brief-only。完整的本地修复包只证明候选本地有效,只能说明本地存在候选修复,不能称为已修复或已完成。推送后需从干净匹配的 checkout 或不可变 CI 产物中的全新进程,在精确推送的 ref 上重放同一案例,证明零跟踪/未跟踪的 issue 相关运行时输入差异,记录匹配指纹,并在实际报告的浏览器或设备上携带无重试热账本(原生选择、焦点、拖放、绘制与 React DOM 生命周期为 5/5)。重放之后的任何 commit、rebase、生成、组合或推送都会使其失效。只有干净的最终推送 ref 重放才能支持“已修复/已完成”措辞。明确授权添加标签也不会豁免这一真实性门禁。

报告者复测失效: 报告者的精确步骤复测优先于先前的 agent 证明。若报告者表示故障仍在:将先前的已修复/已完成声明归类为被推翻;移至 needs-repro 并排除出已完成队列;对比报告者动作与结束状态与案例记录的设置、输入、预期结果与环境,找出缺失的拓扑、需求、环境或最终 ref 重放;将任何完成标签视为需在当前变更权限下纠正的过期公开状态;在 Bug fix playbook 的失败修复恢复下路由一个新的有界修复包。不得用单元测试、评审或绿色代理路由为旧证明辩护。

匹配门禁(Fit Gate): 自主路由前,事项必须:符合根 VISION.md 与相关细节准则;有当前实时来源;无活跃所有者、PR、分支、指派人或近期认领冲突(除非用户明确要求接管);有清晰的所有者技能/包/文档面;有诚实证明路径,包含一个精确可观察案例及其记录的设置、输入、预期结果和最终 ref 重放计划;不需要新功能、配置选项或产品决策;有足够的公开入口上下文供本地维护会话使用,或明确请求缺失上下文;不要求外部凭证、破坏性操作或未经用户明确授权的公开变更;不依赖仅标题或仅 AI 证据。匹配度不明确时,生成可决策的 brief 而非猜测。

权限边界: 默认是读取、分类、路由、在执行所有者允许时修补本地文件并交接。根据报告者有效包准备公开文本,仅在当前明确的用户授权下发布。纯本地工作必须描述为候选。 硬性停止项:commit、push、PR 创建、分支创建、合并、关闭、标签、重新打开、评论、评审提交、发布;外部发送/发帖;凭证、付款、2FA、验证码、账户注册或密钥处理;需要维护者批准的安全披露措辞;破坏性清理或不可逆仓库操作。若用户明确要求其中一项,通过正确所有者执行并记录证明。

最终交接: 运行页面 Close 报告仓库与模式、队列快照路径与新鲜度、检查的队列切片、选中事项与所有者、候选矩阵摘要、实时 GitHub 证明或认证阻塞、重复/认领守卫、执行与证明命令、公开变更、变更列表、运行产物与需用户关注项。交接应简短,让维护者无需阅读原始 diff 或 issue 转储即可批准下一步。

限制: 该技能依赖本地 maintainer checkout、gh 认证与网络;认证或网络受阻时只能使用过期账本作为上下文。它本身不执行修复,修复取决于对应 playbook 或执行所有者。公开安全报告须先私下路由,披露未修补漏洞的公开 issue 不应按普通队列处理。