用途:自动化向 packages/devtools_app/release_notes/NEXT_RELEASE_NOTES.md 添加发布说明条目。
主要流程:先拟定条目(用过去时,句末加句号),再查找对应 PR 编号,确定所属分区(如 Inspector、Memory 等),然后通过脚本写入,最后按需添加图片。
查找 PR 编号可用 git branch 或 git log 确认本地分支,使用 GitHub CLI 时务必加 PAGER=cat: PAGER=cat gh pr list --head <branch_name> --json number,title 或按关键词搜索: PAGER=cat gh pr list --search "<keywords>" --limit 5 也可用网络搜索定位 GitHub 上的 PR。
条目模板:
- <Description>. #<PR_NUMBER> 若确实找不到 PR,可先用 TODO 占位。
写入可用提供的脚本: dart .agents/skills/adding-release-notes/scripts/add_note.dart "Inspector updates" "Added XYZ support" TODO
仅记录面向用户的变更,避免内部实现细节(如内部类名、build 方法改动)。分区包括 General、Inspector、Performance、CPU profiler、Memory、Debugger、Network profiler、Logging、App size tool、Deep links tool、VS Code sidebar、DevTools extension、Advanced developer mode 等更新。
图片放入 packages/devtools_app/release_notes/images/,引用格式: 截图需使用深色模式。
限制:资料未提供脚本的完整参数说明、错误处理方式及自动化程度等细节。