Flutter 仓库中定位 Commit 首发发布版本：find-release 技能与 find_release.dart 工具实战

跨平台前端移动开发OpenHarmony【免费下载链接】flutter_flutter本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。项目地址https://gitcode.com/CPF-Flutter/flutter_flutter点击查看免费下载本文以 CPF-Flutter/flutter_flutterFlutter SDK 与 Engine 的 OpenHarmony 适配仓库中的find-release技能文档为主体完整讲解给定一个 commit SHA如何确定它最早进入哪个 Flutter/Dart 发布版本这一典型问题的解决流程包括参数提取、find_release.dart工具的调用方式与输出字段解读并结合当前仓库中 技能定义、依赖声明文件 与 技能规范说明 说明该技能在本仓库中的落地细节。读完本文你可以独立完成一次commit → 首发 release的查询并理解该技能在 Agent Skills 体系中的位置与校验方式。一、find-release 技能的定位Agent Skills 体系中的一个专用工作流find-release技能定义在 SKILL.md 中其 frontmatter 元信息声明了名称与适用场景name:find-releasedescription: 查找包含指定 commit 的最低 Dart 与 Flutter 发布版本。只要用户询问某个 commit 何时进入了 Flutter 或 Dart 的发布版本、询问特定 SHA 对应的发布版本或想知道某个 commit 是否已包含在 Flutter/Dart 项目的stable、beta、dev渠道中都应使用此技能。从源码结构看该文件位于.agents/skills/目录与flutter-pr-checks-finder、rebuilding-flutter-tool等技能并列。.agents/skills/README.md 对该目录的规范要求包括技能命名遵循 Claude 命名规范、技能内容遵循 agentskills.io 的开放标准、一个 CLI 工具对应一个技能、脚本优先使用 Dart 编写等。此外仓库还提供了dart_skills_lint工具用于校验技能文件可检查行尾空白、绝对路径、相对路径是否指向存在的文件校验命令在dev/tools目录下执行dart run dart_skills_lint:cli --skills-directory ../../.agents/skills \ --check-trailing-whitespace --check-absolute-paths --check-relative-paths有一个值得注意的细节dart_skills_lint_ignore.json 中find-release技能被显式豁免了check-relative-paths相对路径存在性检查这一条规则。原因是该技能文档中引用的find_release.dart工具位于 Dart SDK 检出目录之下见下文该目录属于 gclient 依赖、在纯框架检出中并不存在实体文件。这从配置层面印证了该工具文件并非本仓库直接检入的源码而是随 Dart SDK 依赖提供的——这也正是技能文档要求通过环境变量FIND_RELEASE_TOOL_PATH覆盖工具路径的原因。二、技能工作流程三步完成commit → 首发 release查询技能文档SKILL.md给出的完整工作流分为三个阶段提取信息、执行搜索、解读并汇报结果。第一步从用户请求中提取关键信息commit SHA从用户的请求中识别目标提交例如02abc57短 SHA 或完整 SHA 均可由工具内部完成匹配。目标渠道channel取值限定为stable、beta、dev三者之一。如果用户没有指定渠道技能要求对每个渠道分别尝试。第二步执行 find_release.dart 工具技能文档明确要求先确保find_release.dart工具可用再用其路径执行从而保证命令在仓库工作区内的任意目录都能运行。工具默认位于工作区根目录下的engine/src/flutter/third_party/dart/tools/find_release.dart如果工作区根目录不是默认布局例如本适配仓库这类以 gclient 管理引擎依赖的检出则需设置环境变量FIND_RELEASE_TOOL_PATH指向工具的绝对路径。标准命令格式为dart run ${FIND_RELEASE_TOOL_PATH:-engine/src/flutter/third_party/dart/tools/find_release.dart} --commitSHA --channelCHANNEL参数说明参数/变量取值说明--commitcommit SHA如02abc57待查询的提交工具会判断它属于dart-lang/sdk还是flutter/flutter仓库--channelstable/beta/dev目标发布渠道不合法时工具默认回落到stable并提示用户FIND_RELEASE_TOOL_PATH工具的绝对路径可选用于非默认工作区布局未设置时回落到相对路径engine/src/flutter/third_party/dart/tools/find_release.dart当前仓库中该工具路径的来源在本仓库的 DEPS 文件中engine/src/flutter/third_party/dart被声明为 gclient 依赖指向 Dart SDK 仓库Var(dart_git) /sdk.git Var(dart_revision)其中dart_revision固定为a29e08c72e2ce21813c1edf50cbcdfcac7a7acdd见 DEPSOpenHarmony 侧的 DEPS_ohos 同样声明了该依赖第 303 行。因此find_release.dart工具由 Dart SDK 检出提供只有执行过gclient sync之后该目录才会实际存在在本适配仓库中引擎依赖的同步入口是engine/ohos脚本其底层调用python3 ./src/flutter/attachment/scripts/ohos.pygclient 引导文件为 engine/scripts/ohos.gclient其deps_file指向DEPS_ohos如果当前检出没有执行引擎依赖同步engine/src/flutter/third_party/dart/tools/find_release.dart将不存在此时按技能文档的建议应设置FIND_RELEASE_TOOL_PATH指向一个含该工具的完整工作区中的绝对路径再执行。第三步解读并汇报结果工具执行后的输出与汇报规则在技能文档中有明确约定所属仓库工具会报告该 commit 在哪个仓库中被找到——dart-lang/sdk或flutter/flutter。Lowest release tag包含该 commit 的最低 git 发布标签tag。Lowest Flutter release / Lowest Dart release针对指定渠道stable/beta/dev给出的最低 Flutter 发布版本号和/或最低 Dart 版本号。汇报时应将上述发现清晰呈现给用户如果 commit 未找到、或尚未进入该渠道的任何发布版本应如实告知而不是给出推测性结论。边界情况处理技能文档明确要求SHA 无效或未找到 → 建议用户核对 SHA 是否正确渠道参数无效 → 工具默认回落到stable同时需通知用户这一默认行为。三、文档内置示例两个典型问答场景技能文档自带两个端到端示例直接说明了用户提问 → Agent 动作的对应关系场景 1用户问 When did commit 02abc57 land in stable?commit 02abc57 何时进入 stable。 Agent 执行dart run ${FIND_RELEASE_TOOL_PATH:-engine/src/flutter/third_party/dart/tools/find_release.dart} --commit02abc57 --channelstable并向用户汇报返回的发布版本号。场景 2用户问 Is 02abc57 in beta?02abc57 是否在 beta 中。 Agent 执行同样的命令仅将参数改为--channelbeta再依据输出判断该 commit 是否已包含在 beta 渠道的发布中。这两个示例覆盖了技能最核心的两类诉求回溯查询某 commit 首次随哪个版本发布与归属查询某 commit 是否已进入指定渠道。四、在 CPF-Flutter/OpenHarmony 适配仓库中的使用要点结合本仓库的实际结构使用find-release技能时有三点值得注意工具路径依赖 gclient 检出与上文一致find_release.dart随 Dart SDK 依赖DEPS、DEPS_ohos提供。在仅拉取框架代码的检出中执行命令会报文件不存在这是预期行为而非命令写错——正确做法是按技能文档设置FIND_RELEASE_TOOL_PATH环境变量指向完整工作区。引擎同步入口本仓库构建 OpenHarmony 版 Flutter Engine 的依赖同步通过engine/ohos脚本完成gclient 配置见 engine/scripts/ohos.gclient指向 gitcode 上的 openharmony-tpc/flutter_flutter 仓库、使用DEPS_ohos作为依赖文件。完成同步后即可直接使用默认的相对路径执行工具无需额外设置环境变量。技能文件的合规性.agents/skills/README.md要求技能文件通过dart_skills_lint校验本技能因引用了 gclient 依赖路径而豁免了相对路径存在性检查见 dart_skills_lint_ignore.json。若你参考本技能编写新技能建议优先引用仓库内实际存在的文件路径避免类似的豁免配置。五、小结与延伸阅读find-release技能把commit → 首发 release这类高频版本回溯问题固化成了三步标准流程提取 SHA 与渠道 →dart run find_release.dart --commit... --channel...→ 按所属仓库 / Lowest release tag / Lowest Flutter/Dart release三个字段汇报并对无效 SHA、无效渠道等边界情况给出了明确处置策略。它演示了 Flutter 仓库 Agent Skills 体系一工具一技能、结构化指令、明确输出契约的设计范式。延伸阅读路径均为仓库根目录相对路径技能本体.agents/skills/find-release/SKILL.md技能目录规范与校验工具.agents/skills/README.md、.agents/skills/dart_skills_lint_ignore.json工具来源的依赖声明DEPS第 59 行dart_revision、第 296–297 行 Dart SDK 检出声明、DEPS_ohosOpenHarmony 引擎依赖同步入口engine/ohos、engine/scripts/ohos.gclient同类技能参考.agents/skills/flutter-pr-checks-finder/SKILL.md赞分享跨平台前端移动开发OpenHarmony【免费下载链接】flutter_flutter本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。项目地址https://gitcode.com/CPF-Flutter/flutter_flutter点击查看免费下载相关推荐Flutter 工作流实战用 find-release 技能把任意 Commit 定位到首次进入的 Dart/Flutter 发行版Flutter 工作流实战用 find release 技能把任意 Commit 定位到首次进入的 Dart/Flutter 发行版 在 Flutter 开发跨平台移动开发前端UI组件桌面应用CANN 版本发布管理体系release-management 仓库的发布计划、Release Notes 与版本管控规范全解读CANN 版本发布管理体系release management 仓库的发布计划、Release Notes 与版本管控规范全解读 CANNCompute A文档CANNscope 仓库中 jaeger-client-go 的版本发布Release流程详解scope 仓库中 jaeger client go 的版本发布Release流程详解 本文以 scope 仓库内 vendored 的 jaeger cl云原生可观测性容器编排运维创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考