1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | k6-grafana-skills(子技能自身标题为 “k6”,所属仓库自述名称为 “Grafana Skills”,故单列记录) | GitHub API / 仓库 README |
| 作者/维护者 | Grafana Labs(官方组织 grafana) |
GitHub API |
| 来源链接 | https://github.com/grafana/skills/tree/main/skills/grafana-k6/k6 | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars / Forks | 所属仓库 199★ / 17 forks(注:该数字属整个技能合集,不代表本技能个体热度) | GitHub API |
| 最新版本 | 仓库尚无正式 Release,以 main 分支持续更新为准(本子技能最近一次提交为 2026-07-21) | GitHub API |
| 安装方式 | npx skills add grafana/skills,或 Claude Code 专用插件市场安装(claude plugin install grafana-k6@grafana-skills) |
仓库文档 |
2. 功能介绍与亮点
k6 是 Grafana 官方 grafana/skills 仓库中负责生成与校验 k6 负载测试脚本的技能:
- 按类型生成脚本:HTTP、WebSocket、gRPC、浏览器自动化、云端执行等 7 类可运行示例文件覆盖不同测试形态,agent 按用户需求挑选最匹配的模板改写
- 生成 → 校验 → 复核闭环:脚本落盘后自动用
k6 run或k6 inspect实跑一遍,校验通过才算完成,而不是把脚本写完就交差 - 内置最佳实践审查清单:阈值是否齐全、
sleep()是否模拟了真实用户节奏、断言写法是否规范等,按脚本类型分别列出检查项 - 文档查询自动降级:优先用本机
k6 x docs命令查文档,命令不可用时自动退回抓取 grafana.com 官方文档页,不会中断流程
亮点:官方 Grafana Labs 出品(k6 本身是社区知名度较高的开源负载测试工具);本子技能的提交记录中有 k6 核心团队工程师直接参与,非纯打包脚本生成;配套 SETUP.md、最佳实践指南、文档查询指引与可运行示例文件,文档完整度在同批技能中较为突出。
3. 适用场景
固定分类:DevOps 与基础设施
- 需要为 API、网站或微服务编写 k6 负载测试脚本,但不熟悉 k6 各类 executor 与最佳实践的开发者
- 已在用 k6 却缺乏统一脚本规范(漏配阈值、忘记
sleep()导致压测结果失真等)的团队 - 想让 agent 按需求生成正确类型(压力/尖峰/浸泡/断点等)测试脚本并自动跑通验证的 SRE、QA 工程师
4. 跨 Agent 兼容性
- Claude Code:原生支持——仓库提供
claude plugin marketplace add官方安装路径,可单独安装grafana-k6插件组 - Codex:原生支持——README 明确说明通过
.agents-plugin/marketplace.json自动发现,无需手动配置 - OpenClaw:未验证——官方文档未提及
- Hermes Agent:未验证——官方文档未提及
5. 推荐理由
k6 是社区常用的开源负载测试工具,但写出一份合格的测试脚本涉及 executor 选型、阈值设计、用 sleep() 模拟真实用户行为等大量细节,新手很容易漏掉,导致压测结果失真甚至 CI 无法感知真实的性能回归。这份技能把生成、本地实跑校验、最佳实践复核串成一条闭环,每次生成脚本都会先跑一遍再对照检查清单复核,减少“脚本能跑但结果没意义”这种常见坑。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Grafana Labs 官方出品,已被 SkillsMP、ClaudePluginHub 等第三方 Agent Skill 目录收录;但所属仓库 2026 年 3 月才创建,本子技能自身独立提交记录(3 次,含 k6 核心团队工程师参与)尚年轻,未达一线爆款量级 |
| 可用性 | 8 | npx skills add 一条命令即可安装;SKILL.md 连同 SETUP.md、最佳实践指南、文档查询指引、可运行示例文件覆盖完整;近期仍有提交,维护活跃;唯一前提是本机需预装 k6 CLI(免费开源工具) |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:
① Shell 命令执行——仅限本地运行 k6 run/k6 inspect 及文档查询命令,脚本写入路径限定在项目内的 k6/scripts/ 目录
② 联网外发——测试流量目标由用户指定(负载测试本身即需联网到被测服务);文档降级抓取指向 grafana.com 官方域名,透明可查;上传到 k6 Cloud 属可选功能,需用户主动触发
③ API Key/凭据——仅在选用 k6 Cloud 时才涉及,凭据由 k6 CLI 自身标准登录流程管理,技能本身不收集
④ SKILL.md 与脚本内容检查——未发现可疑指令或 prompt injection 迹象
⑤ 作者信誉——Grafana Labs,知名开源可观测性与性能工程公司
⑥ License——Apache-2.0,清晰
⑦ 维护时间——近期仍有提交,非弃置项目
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 k6(本技能)的差异 |
|---|---|---|
| k6(本技能) | 通用 k6 测试脚本生成:覆盖 HTTP/WebSocket/gRPC/浏览器/云端等全部 executor 类型,内置生成→校验→复核闭环 | 面向“从零写一份正确的 k6 脚本”这一通用场景 |
| k6-perf-test-website(同仓库姊妹技能) | 针对公开网站的端到端性能测试,产出协议+浏览器混合套件、SLO 阈值、负载生成器监控旁车与 Grafana 排查手册 | 聚焦“网站整体性能压测”这一更具体的复合场景,产出物比单个脚本更重 |
| grafana-k6-skills(KimDoubleB 个人维护项目) | 独立第三方维护的 k6 技能包,MIT 协议 | 非官方出品,仓库创建于 2026 年 3 月后再无更新,活跃度与文档完整度均低于官方版本 |
8. 用户评价
该技能已被 SkillsMP、ClaudePluginHub 等第三方 Agent Skill 目录收录,但目前尚未见到具名用户在社区平台发表的使用点评。
9. 其他补充
本技能隶属于仓库的 grafana-k6 插件组,通过 Claude Code 安装该插件组时会连带装入 k6-docs(k6 自身文档维护)、k6-perf-test-website、k6-manage、k6-cloud-investigate-test 等共 7 个相邻技能,并非单独安装。仓库整体覆盖 7 大插件组、40 余个细分技能,本技能只是其中面向“生成 k6 测试脚本”场景的一个。
10. 安装使用方式
- 通用(推荐多数工具):
npx skills add grafana/skills - Claude Code:先
claude plugin marketplace add grafana/skills,再claude plugin install grafana-k6@grafana-skills - Cursor:同样执行
npx skills add grafana/skills,会写入项目内的.cursor/skills/ - Codex 及其他遵循 Agent Skills 标准的工具:通过仓库自带的
.agents-plugin/marketplace.json自动发现,无需手动配置
安装后无需重启,agent 会在检测到用户在写 k6 测试脚本或提到“压测”“负载测试”等需求时自动加载对应 SKILL.md。实际执行验证步骤前,需要本机已安装 k6 CLI(v1.7.0+ 可自动 provisioning 文档子命令,更早版本需手动构建 xk6 插件)。
11. 注意事项
- 该技能所在仓库创建于 2026 年 3 月,相对年轻,尚未形成成熟的第三方评价生态
- Claude Code 安装粒度是整个
grafana-k6插件组而非单个技能,会连带装入其余 6 个相邻技能 - OpenClaw、Hermes Agent 的兼容性未在官方文档中提及,使用前建议自行验证
k6 x docs文档查询功能依赖本机 k6 版本(v1.7.0+ 免构建),更早版本需额外构建 xk6 插件,否则技能会自动降级为抓取 grafana.com 网页文档- 若选用 k6 Cloud 运行(可选功能),需要用户自备 Grafana Cloud 账号与凭据