SuperAPI AI 工具集

cycle

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:为编排 PR 审查循环提供参考知识。过程性工作流位于 /cycle:pr,本技能提供该工作流依赖的模式与经验。触发场景包括:/cycle:pr 在多 PR 模式下需要领域知识;正在设计或调试批量 PR 审查流程;需要了解 CodeRabbit 行为、worktree 管理或跨 PR 模式。

监控模式:CodeRabbit 与 GitHub Actions 时序可预测。推送后 10-30 秒 CI 启动(查 gh pr checks <N>),1-5 分钟 CI 完成,推送后 1-3 分钟 CodeRabbit 出审查。建议首次在 2-3 分钟轮询,之后每 3-5 分钟一次;CodeRabbit 约 3 轮后收敛,超过 3 轮仍有新评论应查是否反复出现同一模式。轮询内容包含 CI 状态、行内评论、审查汇总与 PR 一般评论,资料给出了对应 gh 命令。干净状态需同时满足:检查全绿、无未解决行内评论、无 CHANGES_REQUESTED、与基分支无冲突。

修复派发:采用派发并轮询,而非团队消息。每个后台代理接收指定评论、修复、提交、推送后报告并退出,不等待复审,由监控循环负责重查。代理提示模板位于 templates/pr-agent-prompt.md,需填入 worktree 路径、分支、PR 号、仓库坐标与评论列表,并含必须完成段以防代理编辑后未提交。worktree 可用时并行派发;同仓库无 worktree 时串行;某 PR 已有代理运行时等待其完成。

worktree 管理:用 git worktree add 创建,用 git worktree list 查看。注意共享对象库但工作树独立;预推送钩子可能失败,人工构建验证后可用 SKIP_PREPUSH=1;合并后及时 git worktree remove,并定期 git worktree prune。派发时应提供绝对路径。

跨 PR 情报:同一风格评论出现在两个以上 PR 属约定问题,应全量修复;架构反馈需评估跨 PR 影响;合并冲突警告时先合并较简单 PR 再变基;共享依赖变更在一个 PR 修复并在其他 PR 验证。合并顺序遵循依赖优先、差异最小优先,每次合并后其余 PR 可能需重跑 CI。

CodeRabbit 细节:推送后 1-3 分钟发初始汇总与行内评论,每次推送复审但只评论新增或改动代码,通常 2-3 轮收敛,可能重提已解决评论;行为由仓库根 .coderabbit.yaml 控制,无审查时检查该文件或关闭再重开 PR,可用 @coderabbitai resolve 解决讨论串。缺陷与安全问题立即修,风格问题也修,误报可回复说明。

错误恢复:代理未提交可恢复或接管;CI 因无关测试失败可 gh run rerun --failed;合并冲突用 git rebase main;CodeRabbit 不发评论检查配置或重开 PR;范围蔓延另建 issue;同一问题修复 3 次即升级;worktree 异常可 git worktree remove --force 后重建。其余细节资料暂未提供。