SuperAPI AI 工具集

community-pr-batch-review

编程与开发

查看项目

更新于 10-22 19:27

技能介绍

用途

community-pr-batch-review 是一个用于协调一批相关 unifi-mcp 社区 PR 审查的技能。它本身不替代单个 PR 的审查门槛,而是指导如何跨多个 PR 组织评审团队、共享上下文并保留每个 PR 的独立证据。使用该技能协调批量任务时,每个 PR 的审查门槛仍应使用 community-pr-review 技能。当前用户指令和受信任的基础分支 AGENTS.md 优先于过时的技能细节。作者的任职时间、提交量或假定的 agent 使用情况不决定所报告问题是否有效。

主要能力

  • 范围与固定清单:首先记录用户授权的范围(分诊、审查、修复或交付),并在各批次中沿袭该授权,不针对每个 PR 重复询问。审查授权本身不授权联系贡献者或合并。使用现有计划和 Myco 保存批量进度;可变结果应保存在本地证据账本或计划中,而非技能文件内。刷新 PR 头、目标基础分支、合并基础、变更文件和 GitHub 状态,并显式记录每次比较。
  • 分组与归属:按共享行为和代码对 PR 分组,区分语义交互、源前置条件、生成文件重叠和已发布包前置条件。每个 PR 分配一个主要所有者和独立处置。对设计适配未解决的提案予以搁置;有可用 agent 槽位不是执行不必要审查的理由。
  • 滚动团队调度:尊重可用槽位。一种四槽布局是编排者、两名领域审查员和一名轮换独立验证员。无委托执行能力时按顺序运行相同数据包。使用内部 agent,而非新建用户任务。不递归增加审查员。并行工作需要当前指令授权和宿主对委托执行的支持。若委托不可用或被禁止,则顺序运行数据包。
  • 有界数据包:给每个领域审查员一个有界数据包,通常包含一至三个相关 PR。提供固定修订、受信任规则、相关锚点、待检验假设、独占输出路径、执行限制和报告模板。当委托指导要求时,逐字包含当前 Myco Cortex 指令。槽位空出时复用审查员处理相关数据包,不在整批屏障处等待。被分配的工作者仅执行其数据包;编排者负责共享清单、Myco 进度和外部操作;工作者将证据返回给所有者。
  • 独立挑战与测试归属:对复杂变更,向另一工作者分配独立的代码/测试挑战,并在分享主要审查结论前收集其初步观察。为测试执行指定明确所有者,避免主要审查员和验证员重复运行同一套件。编排者并行准备共享测试基础设施,并对重要发现进行裁定,而非重读所有差异。
  • 可执行证据保留:在运行 fork 代码前检查可执行/构建/工作流变更。使用隔离的源代码和依赖,不携带宿主机凭据或共享可写状态;仅工作树不是沙箱。记录实际导入来源、运行时/依赖、命令、代码修订、配置和退出状态。共享上下文和基线观察,而非结论或跨不同修订的通过测试声明。在测试命名空间冲突时分开包 pytest 调用。为日志分配唯一且独占创建的路径。无效或混合来源要求重新运行受影响检查,而非将其重新解释为 PR 回归。
  • 发现分类与硬件证据:将功能发现、策略违规、现有局限和包最低要求区分开。要求具体触发条件和后果。对照适用边界确认隐私声明;原始清单标识符本身不构成秘密泄露违规。空发现集是有效的。编排者负责实时控制器调度;需要硬件证据时使用 live-smoke-testing 技能,针对变更行为并保持控制器会话串行直到建立独立性。保留变更操作的授权和清理要求。缺失硬件或 CI 证据保持为可见门槛。
  • 合成与刷新:为每个 PR 收集一份紧凑报告:修订/比较、覆盖路径、已验证声明、带行证据的可操作发现、确切检查、限制、依赖、建议和下一位所有者。通过来源和复现而非投票或发现数量来调和分歧。保留问题有效性、实现质量和合并准备度之间的区别。在最终合成或授权交付前刷新头和基础分支。头变更会使旧报告的笼统复用失效;检查差异及其影响。基础推进需要单独的兼容性评估。保留原始证据标签并解释任何结转证据。组合树检查不证明独立 PR,干净 Git 合并不证明行为。按选定集成顺序重新生成共享工件。将共享修复分配给一名编辑,并遵循 monorepo-release-pipeline 处理发布门槛。不削弱 GitHub 保护或将缺失检查视为通过。仅执行用户范围涵盖的外部操作。
  • 收尾:以每个 PR 的处置、剩余门槛和建议顺序结束,并附简短过程回顾。记录重复工作、无效证据、有用的独立发现和协调成本。仅在观察到问题时更改工作流;并发本身不是加速的证明。

使用方式

调用该技能开始协调批量审查:首先记录用户授权范围并固定 PR 清单,刷新各 PR 的头部与基础分支状态;然后按共享行为和代码分组,为每个 PR 分配主要所有者;根据可用槽位和委托执行能力组建滚动团队,给领域审查员分配有界数据包;对复杂变更安排独立挑战和测试归属;保留可执行证据并区分发现类型;最后刷新头与基础分支,合成每个 PR 的报告和处置建议。

适用场景

适用于需要对多个相关 unifi-mcp 社区 PR 进行有组织批量审查的场景,尤其是 PR 之间存在共享子系统上下文或语义交互时。也适用于需要在有限审查槽位下协调滚动团队、保留独立验证证据的批量审查工作。

限制

  • 每个 PR 的审查门槛仍由 community-pr-review 技能负责,本技能仅协调批量流程。
  • 审查授权不授权联系贡献者或合并;仅执行用户范围涵盖的外部操作。
  • 并行工作依赖当前指令授权和宿主对委托执行的支持;若不可用或被禁止,必须顺序运行。
  • 仅工作树不是沙箱,运行 fork 代码需要隔离环境。
  • 缺失硬件或 CI 证据保持为可见门槛,不能视为通过。
  • 不削弱 GitHub 保护,不将缺失检查视为通过。
  • 具体工具集成(如 Myco、Myco Cortex)的细节暂未提供,需参考相关环境说明。