SuperAPI AI 工具集

maintainer-review

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:以 ioredis 维护者身份审查 issue 或 PR,目标是做出维护决策,而不是写通用 diff 摘要。

主要能力:把“声称的行为是否真实”“用户实际需求是什么”“现有受支持功能能否满足”“缺口是否值得现在处理”“若没有这个 PR 维护者是否会主动实现”“是否值得合并与长期维护”“多个竞争 PR 中应选哪条路径”“应给出何种简洁维护者回复”等问题分开评估。将 issue 中请求的字段、回调、标志、类或实现策略视为提议机制,而非已接受的需求。

使用方式:先确定精确的 ioredis 目标(issue 或 PR 类型、编号、基础分支、变更路径),阅读完整报告、评论、复现、环境、链接材料与维护者回复;对 PR 检查 base/head、完整补丁、提交历史、测试、关联 issue 与评审讨论。用一句可证伪的话陈述主张,区分观察到的症状与提议的原因或修复。先完成“未满足需求与设计”评估,再深入实现细节。需求证据状态分为 Demonstrated、Plausible but unproven、Already covered、Unsupported;只有 Demonstrated 才可给出 Merge-worthy。随后按比例发现竞争中的开放 PR,比较需求覆盖、运行时正确性、放置位置、测试、兼容性、复杂度与剩余维护工作。

证据流程:先做桌面审查,检查真实运行时路径、调用方、公开导出、standalone/Sentinel/Cluster 路径、字符串与 Buffer 变体、pipeline/transaction、订阅模式、持久化、清理与相关测试;查阅 AGENTS.md、README.md、docs/ 下生成的 API 文档、examples 与类型测试,以 lib/ 源码为准。涉及清理、重试、重连、取消、监听器、共享 promise 或任务、socket 或流、状态标志等跨 await/回调/事件的可变状态时,必须做交错与所有权检查,追踪至少两个重叠操作 A、B 在挂起或重入点的行为,并检查测试是否覆盖受控交错与存活操作的可观察行为。

限制:审查仅允许只读检查 issue 与 PR,不授权评论、打标签、改分支、推送、合并或其他仓库写入。运行时探测需用户明确批准,且只运行最小必要探测;若用户拒绝,结论保持初步并说明置信度限制。不得用测试证明新代码可运行来替代需求证据;API 对称性、命名一致性属于设计论证而非需求证据。若仓库访问无法确认完整性,应说明而非声称已找到全部候选。