☰

企业官网建设流程全解析

首页 / 建站日记 / 企业官网建设流程全解析
Flutter PR 牧羊人（Shepherd）工作流：用 gh CLI 完成 PR 状态检查、陈旧分支更新与 Autosubmit 落地的标准 Runbook
2026/9/7 3:24:51 网站建设 项目流程

Flutter PR 牧羊人（Shepherd）工作流：用 gh CLI 完成 PR 状态检查、陈旧分支更新与 Autosubmit 落地的标准 Runbook

【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter

本篇围绕 Flutter 仓库中flutter/flutter的 PR 牧羊（shepherding）技能文档，讲解一套可复制的标准作业流程：如何用 GitHub CLI（gh）查询自有及第三方 PR 的状态与检查项、在执行autosubmit贴标前必须完成的四项预检（历史移除原因、base commit 新鲜度、双评审人、全绿检查）、如何手动触发 LUCI 失败构建重试，以及如何用gh pr update-branch与CICD标签处理陈旧分支。读完本文，你可以独立驾驭一条 PR 从"等待 CI 变绿"到"被 autosubmit 机器人自动合并"的完整生命周期。

1. 技能定位：这是给谁用的标准 Runbook

PR 牧羊技能定义于 .agents/skills/shepherd-prs/SKILL.md，其元数据（front matter）声明如下：

  • 名称：shepherd-prs
  • 用途：使用原生 GitHub CLI（gh）命令，自动化地对flutter/flutter仓库中处于开放状态或已获批准的第三方贡献者 PR 进行"牧羊"——即检查状态、更新分支、贴autosubmit标签使其落地。
  • 适用时机：
    • 需要查询开放 PR 或正在牧羊的第三方 PR 的状态时；
    • 需要更新陈旧（stale）分支或对已批准的 PR 施加autosubmit标签使其落地时。
  • 不适用场景：
    • 未获批准的 PR（除非那是你自己的 PR，仅想查看状态）；
    • flutter/flutter以外的仓库。

该技能遵循 Flutter 仓库对共享 Agent 技能的治理规范（见 .agents/skills/README.md）：技能必须面向 Flutter 贡献者、每个 CLI 工具一个专属技能、指令越结构化越好、脚本优先使用 Dart 编写，并且需通过dart_skills_lint工具校验。这意味着本文描述的流程不是临时经验，而是仓库内正式维护、有所有权归属的标准作业程序。

理解"牧羊"的上下文：Flutter 仓库使用 autosubmit 机器人（代码位于 flutter/cocoon 基础设施中）自动验证并合并 PR。开发者给 PR 加上autosubmit标签后，机器人会在所有检查通过、评审满足要求时自动合并；一旦有检查失败或条件不满足，机器人会移除标签并停止处理（见 docs/infra/Autosubmit-bot.md）。因此"牧羊人"的核心价值就是：在贴标之前把机器人会拒绝/撕掉标签的所有坑提前排掉。标签体系（autosubmit、revert、revert of、emergency）的完整说明见 docs/infra/Landing-Changes-With-Autosubmit.md。

2. 检查 PR 状态：四条核心 gh 命令

当需要查看开放或已批准 PR 的状态时，按以下顺序执行：

1. 列出自己名下的开放 PR：

gh pr list --repo flutter/flutter --author <username> --state open --json number,title,url,mergeable,reviewDecision

--json指定的五个字段分别覆盖：PR 编号、标题、URL、可合并状态（mergeable）、评审决议（reviewDecision）——这正是判断一个 PR 是否可以推进的全部关键信号。

2. 列出自己"牧羊"中的第三方 PR（自己做过 review 但非自己作者）：

gh pr list --repo flutter/flutter --search "reviewed-by:<username> -author:<username> is:open" --json number,title,url,mergeable,reviewDecision

这里的--search使用的是 GitHub 搜索语法：reviewed-by:<username>表示该用户已评审过，-author:<username>排除自己作者身份，is:open限定开放状态。

3. 检查 PR 的详细检查项：

gh pr checks <number> --repo flutter/flutter

4. 检查评审、标签与评论：

gh pr view <number> --repo flutter/flutter --json labels,reviewDecision,reviews,comments

第 4 条命令的输出是后续所有预检判断的数据来源：labels用于确认autosubmit/CICD是否在场，reviews用于统计团队成员批准数，comments用于检索 auto-submit 机器人历史消息。

3. 贴 autosubmit 标签前的四项预检规则

在给 PR 施加（或重新施加）autosubmit标签之前：

gh pr edit <number> --repo flutter/flutter --add-label autosubmit

必须先完成以下四项起飞前检查（pre-flight verification），确保auto-submit机器人不会拒绝或撕掉该标签。

3.1 检查 autosubmit 被移除的历史记录

通过查看 PR 评论，确认autosubmit标签是否曾被auto-submit机器人移除过：

gh pr view <number> --repo flutter/flutter --json comments

在评论中查找来自auto-submit的"autosubmit label was removed..."类消息。如果标签此前被移除过，必须找出机器人陈述的确切原因（CI 检查失败、批准不足、合并冲突、分支陈旧等），并确认该问题确实已解决后再重新贴标。这与 docs/infra/Autosubmit-bot.md 中"任何测试失败都会导致标签被移除、机器人停止处理该 PR"的行为描述完全一致——盲目重贴而不排查原因只会陷入"贴标—撕标"循环。

3.2 验证 base commit 新鲜度（超过 7 天即视为陈旧）

检查 PR 的 base commit 是否已陈旧（超过7 天）。如果 base commit 超过 7 天：

  • 必须先执行分支更新，再考虑贴autosubmit：
gh pr update-branch <number> --repo flutter/flutter
  • 在分支更新完成、且更新后分支的 CI 检查全部成功之前，不得施加autosubmit。

3.3 严格验证必需的团队成员批准

对第三方贡献者的 PR（作者角色为CONTRIBUTOR、FIRST_TIME_CONTRIBUTOR、NONE），施加autosubmit之前必须确认至少存在2 个团队成员批准（MEMBER或OWNER角色），否则机器人会再次撕掉标签。通过以下命令核查：

gh pr view <number> --repo flutter/flutter --json reviews

这条规则与 autosubmit 机器人的官方评审规则互相印证：在 docs/infra/Autosubmit-bot.md 中，机器人区分作者是否为flutter-hackers组织成员——成员作者的 PR 需要至少 1 个组织成员的额外评审（最好来自代码所有者），非成员作者需要至少 2 个组织成员的额外评审；且只要有任何一位评审人发起"请求更改"（request changes），无论已有多少批准，PR 都不会被合并，autosubmit标签会被移除，直到发起更改请求的评审人重新批准。

3.4 验证全部状态检查 100% 通过

Flutter 的 autosubmit 机器人在任何 CI 检查失败时会自动撕掉autosubmit标签。因此：

  1. 确认所有状态检查均处于通过状态（SUCCESS/pass）；
  2. 如果有任何检查处于 flaky、失败或等待重试状态：
    • 不要立即贴autosubmit标签；
    • 告知用户哪个检查失败，并指示其先重试该检查；
    • 只有当所有重试的检查都成功完成后，再执行：
gh pr edit <number> --repo flutter/flutter --add-label autosubmit

4. 第三方贡献者 PR 的双评审人要求（专章强调）

这一条在技能文档中独立成章，因为它是机器人撕标最高频的触发点：

  • 由第三方贡献者（CONTRIBUTOR、FIRST_TIME_CONTRIBUTOR、NONE）提交的 PR，要求 Flutter 团队成员（MEMBER或OWNER）的两次明确批准，之后 autosubmit 机器人才会合并它；
  • 如果只有 1 个团队成员批准时就贴上autosubmit标签，机器人会直接移除该标签；
  • 动作：通过gh pr view <number> --repo flutter/flutter --json reviews严格核实至少存在 2 个团队成员批准，然后再贴标。若只有 1 个批准，提醒用户先请求第二位评审人。

5. 失败检查与手动 LUCI 重跑

由于 GitHub App 权限策略限制，第三方检查运行（例如由flutter-dashboard创建的 LUCI 检查）无法通过 GitHub API 重跑。因此当检查失败时，标准处置流程为：

  1. 打印出该失败检查对应的精确 LUCI Buildbucket 链接（形如https://cr-buildbucket.appspot.com/build/<build_id>）；
  2. 指示用户打开该 URL，并在 LUCI 页面点击Retry Build；
  3. 如果手动重试后检查仍然失败，则检查失败日志（通过gh pr view <number> --repo flutter/flutter，或使用同仓库的 flutter-pr-checks-finder 技能）并为用户总结失败原因。

补充背景：这些检查对应 .ci.yaml 中声明的 CI 任务清单——Flutter 基础设施用该文件为每个 commit 生成待执行任务列表，其中flutter_dronerecipe 会将分片（shard）测试委托给仓库内的dev/bots/test.dart执行（分片如analyze、test_general等）。这也解释了为什么失败检查通常成组出现、且需要逐个确认重试结果。

6. 陈旧分支更新、CICD 标签与 Token 作用域

这是牧羊流程中最容易卡住的环节，技能文档给出了三条配套规则：

6.1 分支陈旧就先更新

如果 PR 分支落后于master（包括 base commit 超过 7 天的情形），在尝试添加autosubmit之前，必须先执行：

gh pr update-branch <number> --repo flutter/flutter

6.2 更新分支后重新施加 CICD 标签

执行gh pr update-branch（或牧羊一个尚未跑过 CI 的 PR）之后，CICD标签常常被撕掉，或需要重新加上以在更新后的 commit 上触发 CI 检查。因此：

  • 每次分支更新后，检查CICD标签是否仍在；
  • 缺失则重新施加：
gh pr edit <number> --repo flutter/flutter --add-label CICD

关于CICD标签的作用机制：对于启用了 Unified Check Run 功能的账号，带有CICD标签的 PR 会将多个 check-run 合并为单一的Dashboard Checks/Flutter Presubmitscheck-run，可通过"View more details on flutter-dashboard"链接进入 presubmit 仪表盘查看逐任务详情并重跑失败任务（见 docs/infra/Unified-Check-Run-User-Manual.md）。

6.3 处理 Token 作用域过期错误

如果分支更新因 workflow 文件权限失败（报错形如ERROR: ... lacks the "workflow" scope），指示用户刷新 CLI 的授权作用域：

gh auth refresh -h github.com -s workflow

7. 目标分支纠正与合并冲突

  • 评审作废警告：更改 PR 的目标分支（target branch）经常会导致 GitHub自动作废（dismiss）已有的批准。如果检测到目标分支发生过变更，必须提醒用户在 GitHub 上重新执行评审批准，否则 3.3 节的双批准条件会不满足，autosubmit 必然撕标。
  • 合并冲突：如果 PR 存在冲突（mergeable字段为CONFLICTING），通知用户让作者自行解决冲突。这与 autosubmit 机器人的 merge-ability 检查对应——机器人会在合并前检查可合并性，并主动通知作者冲突情况（见 docs/infra/Autosubmit-bot.md）。

8. 牧羊流程速查

把以上规则串起来，一条 PR 的完整牧羊路径是：

# 1. 找到要牧羊的 PR gh pr list --repo flutter/flutter --search "reviewed-by:<username> -author:<username> is:open" --json number,title,url,mergeable,reviewDecision # 2. 看检查是否全绿（失败则先手动重跑 LUCI，见第 5 节） gh pr checks <number> --repo flutter/flutter # 3. 查评审数与机器人历史（确认 2 个团队批准、排查 autosubmit 撕标原因） gh pr view <number> --repo flutter/flutter --json labels,reviewDecision,reviews,comments # 4. base commit 超过 7 天或落后 master 时，先更新分支 gh pr update-branch <number> --repo flutter/flutter gh pr edit <number> --repo flutter/flutter --add-label CICD # 更新后若缺 CICD 标签则补上 # 5. 全部检查成功 + 批准数达标后，最后贴标 gh pr edit <number> --repo flutter/flutter --add-label autosubmit

四条不变式贯穿始终：先看机器人撕标原因再重贴；base commit 超 7 天先更新分支；第三方 PR 必须凑齐 2 个MEMBER/OWNER批准；任何一项检查未通过都不贴标。遵循这套预检顺序，auto-submit机器人就会在你贴上标签后顺利完成验证并自动合并，无需人工盯守 CI。

【免费下载链接】flutterFlutter makes it easy and fast to build beautiful apps for mobile and beyond项目地址: https://gitcode.com/GitHub_Trending/flutter41/flutter

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

标签： 网站建设 企业官网 项目流程 UI设计 前端开发

热门文章

文章分类

标签云

网站建设 响应式设计 用户体验 SEO优化 前端开发 小程序 电商平台 性能优化

相关文章

您可能感兴趣的其他内容

CS自学指南中的南京大学 NJU OS 操作系统课程：并发状态机视角、对象化 OS 体系与 MiniLab 实战
2026/9/7 3:23:22 网站建设

CS自学指南中的南京大学 NJU OS 操作系统课程：并发状态机视角、对象化 OS 体系与 MiniLab 实战

CS自学指南中的南京大学 NJU OS 操作系统课程&#xff1a;并发状态机视角、对象化 OS 体系与 MiniLab 实战 【免费下载链接】cs-self-learning 计算机自学指南 项目地址: https://gitcode.com/GitHub_Trending/cs/cs-self-learning 本文以《CS 自学指南》&#xff08;cs…...

阅读更多 →
嵌入式扫码模块选型避坑指南：尺寸、接口、码制与屏幕码实战解析
2026/9/7 3:22:47 网站建设

嵌入式扫码模块选型避坑指南：尺寸、接口、码制与屏幕码实战解析

作为搞嵌入式开发的老手&#xff0c;谁手上没几个吃灰的扫码模块&#xff1f;说实话&#xff0c;扫码模块这东西&#xff0c;单看参数表个个都差不多&#xff0c;什么“支持一维二维”“识读距离XXcm”&#xff0c;等你真正画完板子、写完驱动、拿去现场一测&#xff0c;才发现…...

阅读更多 →
MemPalace 小模型评估报告全解：75 组本地矩阵跑分、云模型上限测量与幻觉率评分伪影
2026/9/7 3:22:29 网站建设

MemPalace 小模型评估报告全解：75 组本地矩阵跑分、云模型上限测量与幻觉率评分伪影

MemPalace 小模型评估报告全解&#xff1a;75 组本地矩阵跑分、云模型上限测量与幻觉率评分伪影 【免费下载链接】mempalace The best-benchmarked open-source AI memory system. And its free. 项目地址: https://gitcode.com/GitHub_Trending/me/mempalace 本文解读 …...

阅读更多 →

需要专业的网站建设服务？

联系我们获取免费的网站建设咨询和方案报价，让我们帮助您实现业务目标

立即咨询