关于 test-quick
此技能将快速的 Tier 1 单元测试任务委派给 test-runner Agent,支持按变更范围筛选和监视模式,并排除较慢的测试层级。
主要功能
- 01执行 Tier 1 单元测试
- 02指定可选路径或模式
- 03监视模式持续运行
- 04用 --affected 测试变更文件
- 05失败时立即停止
适用场景
- 01小型重构后的快速检查
- 02TDD 期间获取单元测试反馈
- 03测试近期变更影响的文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ laurigates/ claude-plugins --skill test-quick安装后在 Claude Code 中输入/test-quick确认已加载。
详细介绍
何时使用此技能
| 在以下情况下使用此技能…… | 在以下情况下改用 test-full…… |
|---|---|
| 仅运行单元测试,以获得 30 秒以内的快速反馈 | 在提交 PR 前运行完整测试金字塔(单元测试 + 集成测试 + E2E) |
仅运行受近期更改影响的测试(--affected) | 为所有测试层级生成覆盖率或 HTML 报告 |
| 对单元测试运行监视模式 TDD | 对单个失败文件进行迭代(使用 test-focus) |
| 确认小型重构后没有问题 | 对之前运行的测试结果进行分类(使用 test-analyze) |
上下文
- 项目类型:!
find . -maxdepth 1 \( -name 'pyproject.toml' -o -name 'package.json' -o -name 'Cargo.toml' -o -name 'go.mod' \) - 测试目录:!
find . -maxdepth 2 -type d \( -path '*/tests/unit' -o -path '*/test/unit' -o -path '*/__tests__/unit' \) - 上次测试运行:!
find . -path '*/.pytest_cache/v/cache/*' -maxdepth 4 -name 'lastfailed'
参数
$1:可选路径或测试模式--watch:启用监视模式,持续获取反馈--affected:仅运行自上次提交以来有更改的文件对应的测试
你的任务
将此任务委派给 test-runner Agent。
使用 Agent 工具,并设置 subagent_type: test-runner,仅运行快速单元测试。传入上述收集的所有上下文,并指定执行 Tier 1(单元测试)。
test-runner Agent 应:
-
仅运行单元测试(目标用时 < 30 秒):
- 排除慢速测试、集成测试和 E2E 测试
- 使用适用于相应框架的标记/标志:
- pytest:
-m "not slow and not integration and not e2e" - vitest:
--exclude="**/e2e/**" --exclude="**/integration/**" - cargo:
--lib - go:
-short
- pytest:
-
应用选项:
- 如果指定了
--watch:启用持续测试执行 - 如果指定了
--affected:仅测试有更改的文件
- 如果指定了
-
快速失败:在首次失败时停止(
-x或--bail) -
提供简洁的输出:
Unit Tests: [PASS|FAIL] Passed: X | Failed: Y | Duration: Zs Failures (if any): - test_name: Brief error (file:line) Rerun failed: [command] -
后续操作建议:
- 如果全部通过:可以继续开发
- 如果有失败:继续之前先修复(快速失败原则)
- 如果耗时超过 30 秒:建议使用
/test:consult进行优化
向 Agent 提供:
- 上述部分中的所有上下文
- 解析后的参数
- 明确指示:仅运行 Tier 1,跳过慢速测试
该 Agent 擅长:
- 分层测试执行
- 快速反馈循环
- 测试隔离与并行化
评论
支持 Markdown