| name | performance-test-creator |
| description | TestFoundry Stage 2 - Performance Assets: turn reviewed test cases, interface details, and explicit performance targets into k6 performance plans, scenario skeletons, and threshold gap notes. Use when Codex needs performance assets after test-case review is approved. |
Performance Test Creator
作为 TestFoundry Stage 2 的性能资产生成器，该 skill 将已评审通过的测试用例转换成 k6 性能测试资产。默认输出性能测试方案和脚本骨架，重点补齐负载模型、阈值和性能目标缺口，不负责接口功能正确性本身。
Dependency
- 强依赖官方的
playwright-interactive 来读取登录后的性能目标文档、内网说明页和补充约束。
- 在 Codex 中优先安装到
~/.codex/skills/playwright-interactive；在 Claude Code 中安装到 ~/.claude/skills/playwright-interactive 或 .claude/skills/playwright-interactive。
- 如果性能目标和容量约束位于登录态页面而运行环境没有
playwright-interactive，不要用公开搜索或经验默认值替代真实来源，直接提示先安装依赖。
Workflow
- 确认测试用例评审已通过；如果未通过，先返回缺口，不生成性能测试资产。
- 阅读需求文档、测试用例、接口信息和性能目标。
- 从已确认业务流中选择适合作为性能测试入口的路径。
- 将业务流转换成 k6 场景骨架。
- 为不同目标分别设计 load / stress / spike / soak。
- 输出阈值、阶段、并发建议和缺口清单。
Source Access Rules
- 如果性能目标、容量约束或业务前提写在需要登录的内部文档里，优先使用 Playwright 复用浏览器会话读取，不要默认走外部搜索。
- 对内部文档，不使用公开搜索、公共镜像或转译服务作为主获取方式。
- 如果只能读取部分目标或约束，先把可见内容转成 k6 计划，再把缺失指标列入缺口清单。
- 如果关键性能目标仍不可见，明确阻塞项，不要凭经验填默认性能承诺值。
Output Contract
默认输出到 ./tests/{yyMMdd}_{requirement_slug}/performance_tests/。
-
yyMMdd
使用当前本地日期，例如 260309
-
requirement_slug
优先复用 test-case-creator 已使用的需求标识；没有现成标识时，从需求标题、版本短名或用户给定标识生成小写 snake_case
-
示例
./tests/260309_sandbox_v2_1/performance_tests/
-
k6-plan.md
说明性能测试目标、场景选择、数据准备、阈值建议、缺口项。
-
k6-scenarios.js
提供基础 k6 场景骨架，便于继续细化。
如果同一需求已经存在 test_cases/，默认写入同级 performance_tests/，不要另起一个新的需求目录。
Performance Model Rules
load
验证常规负载下是否稳定stress
验证超过预期负载后的退化行为spike
验证突发高峰的瞬时承载能力soak
验证长时间运行的稳定性和资源泄漏风险
不要把这些模式混成一个模糊的”性能测试脚本”。
Relationship With Hurl
- Hurl 业务流可以作为性能测试输入来源。
- 不能直接把 Hurl 当成性能测试脚本。
- 必须补充：
- 并发模型
- stages
- arrival rate 或 VU
- thresholds
- 数据准备与清理策略
Missing Target Rules
如果性能目标未明确，默认显式列出缺口，例如：
- 缺少 TPS 目标
- 缺少 P95 / P99 目标
- 缺少错误率上限
- 缺少并发用户规模
- 缺少测试时长
不要自行发明性能承诺值。
Resources
- 读取
references/k6-scenario-patterns.md，统一 k6 场景设计方式。
- 读取
references/perf-targets-checklist.md，判断性能目标是否足够执行。
- 读取
references/hurl-to-k6-mapping.md，将业务回归流映射到性能测试入口。
- 使用
assets/k6-plan-template.md 和 assets/k6-scenario-template.js 作为默认骨架。
