SuperAPI AI 工具集

k6-docs-release

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:处理 xk6-docs 项目的完整发布流程。注意这不是 k6 的发布,不要加载 k6-release 技能。每次发布前需阅读 AGENTS.md 与 history.md,后者记录了作废版本与经验。任何步骤失败(Slack、GitHub API、proxy 检查等)应最多重试 5 次,因为外部服务不稳定。

预检:推送前本地所有测试与 lint 必须通过。通过 git tag --sort=-v:refname | head -1 查看最新标签并将 patch 号加一确定下一版本;用 git log <last-tag>..HEAD --oneline 收集提交。

推送与打标签:先 git push origin main,等待 CI 通过(gh run list --limit 1),再 git tag v<VERSION> 并 git push origin v<VERSION>,触发发布工作流构建二进制并创建草稿 GitHub release。标签推送后绝不能移动,Go module proxy 缓存不可变。

验证发布:等待 release.yml 完成(gh run list --limit 1 --workflow release.yml),用 gh release view v<VERSION> 确认存在且含资产。

编写发布说明:用 gh release edit v<VERSION> --notes 编辑,技术术语加反引号,按新功能、修复、维护分组,每项链接 commit 哈希,无内容的章节省略。

校验代理:curl -s https://proxy.golang.org/github.com/grafana/xk6-docs/@v/v<VERSION>.info,返回含版本与时间戳的 JSON 即成功,否则等待重试,可能需几分钟。

注册表 PR:在 grafana/k6-extension-registry 的 registry.yaml 中 github.com/grafana/xk6-docs 条目下添加新版本,切功能分支后创建 PR。注册表现要求评审后才能合并,需保持 PR 开启并通知评审者;此时仍可通过 xk6 build 使用,k6 x docs 的 provisioning 需 PR 合并后更新。

Slack 公告:使用 slack 技能发布到 #k6-changelog,只列功能,不列修复与维护;技术术语加反引号并链接 commit。使用纯 Markdown(text 与 * 列表),不要用 Slack mrkdwn 语法或 - 列表。传给 reply.py 时用单引号 heredoc 避免反引号被转义而原样泄漏。

完成前检查:main 上 CI 通过、标签已推送且工作流完成、GitHub release 含二进制/校验和/说明、Go proxy 有该版本、注册表 PR 已开启、Slack 消息已发布。限制:该技能面向 xk6-docs 仓库的发布维护者;具体价格、平台支持等信息资料未提供。