📦 Vitest Config Validator - Vitest配置验证

v1.0.0

Config Validator 验证 vitest.config.ts/js 及 vitest workspace 配置的语法、废弃选项、插件冲突与最佳实践。用于验证 Vi...

0· 21·0 当前·0 累计

by @charlie-morrison

生产力工具办公协作测试工具

下载技能包

最后更新

2026/4/21

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

medium confidence

该技能的代码和说明与一个基于正则表达式的本地 Vitest 配置检查器一致，它会读取文件并报告问题；不会请求凭据或安装软件。

评估建议

该技能是一个基于正则表达式的本地 Vitest 配置检查器，内部逻辑与这一用途保持一致。安装/使用前，请：(1) 检查完整 Python 文件是否存在网络/外联模式（搜索 subprocess、os.system、socket、requests、urllib、http、fetch），确认无隐藏外部调用；(2) 先在样本或非敏感配置文件上运行，并尽量在沙箱环境执行；(3) 避免传入敏感文件或目录路径；(4) 由于工具采用启发式/正则解析而非执行配置，可能出现误报/漏报。若需更高可信度，请提供完整（未截断）脚本以供逐行审查——可将信心提升至“高”。...

详细分析 ▾

✓ 用途与能力

名称/描述（Vitest config validator）与提供的资源一致：仅含指令的 SKILL.md 以及一个解析 vitest.config.ts/js 文件的 Python 脚本。未请求必需的环境变量、二进制文件和配置路径，符合本地验证器的设定。

✓ 指令范围

SKILL.md 要求运行附带的 Python 脚本，对本地配置文件执行检查。该脚本读取目标配置文件，并基于正则表达式进行校验；仓库明确声明其仅解析文本，不执行 JS。说明中未要求访问无关系统文件或外部端点。

✓ 安装机制

无安装规范——仅提供说明及附带的 Python 脚本。风险低，与所述目的相称。无需从 URL 下载或安装任何包。

✓ 凭证需求

该技能无需环境变量或凭据。脚本仅对用户提供的文件路径进行操作，适用于配置 linter。

✓ 持久化与权限

该技能未声明 always:true，也没有安装时钩子。它在提供的元数据或说明中未请求持久性系统级更改或提升权限。

安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/21

首次发布：20+ 条 vitest.config 验证规则

● 无害

安装命令

点击复制

官方npx clawhub@latest install vitest-config-validator

镜像加速npx clawhub@latest install vitest-config-validator --registry https://cn.longxiaskill.com

技能文档

校验 vitest.config.ts 与 vitest.config.js 的语法错误、废弃选项、插件冲突与最佳实践。无需执行 JS，仅用正则解析文本。

命令

bash  
# 全量校验（所有规则）  
python3 scripts/vitest_config_validator.py validate vitest.config.ts  
# 快速语法检查（仅结构规则）  
python3 scripts/vitest_config_validator.py check vitest.config.ts  
# 以人类可读方式解释配置  
python3 scripts/vitest_config_validator.py explain vitest.config.ts  
# 给出改进建议  
python3 scripts/vitest_config_validator.py suggest vitest.config.ts  
# JSON 输出  
python3 scripts/vitest_config_validator.py validate vitest.config.ts --format json  
# 单行 PASS/WARN/FAIL 摘要  
python3 scripts/vitest_config_validator.py validate vitest.config.ts --format summary

# 严格模式（警告视为错误） python3 scripts/vitest_config_validator.py validate vitest.config.ts --strict`

`规则（22 条）`


| # | 类别 | 级别 | 规则 |  
|---|------|------|------|  
| S1 | 结构 | E | 文件不存在或不可读 |  
| S2 | 结构 | E | 配置为空或未调用 defineConfig |  
| S3 | 结构 | W | 未找到默认导出 |  
| S4 | 结构 | W | 同时存在 vitest.config 与带 test 段的 vite.config |  
| S5 | 结构 | W | 未知顶层配置键 |  
| T1 | 测试设置 | E | 无效 test environment（需 jsdom/happy-dom/node/edge-runtime） |  
| T2 | 测试设置 | W | include/exclude 模式为空 |  
| T3 | 测试设置 | E | include/exclude 中的 glob 模式无效 |  
| T4 | 测试设置 | I | 未设置 coverage provider（推荐 c8/v8/istanbul） |  
| T5 | 测试设置 | W | testTimeout 设置过高（>60000 ms）或过低（<100 ms） |  
| P1 | 性能 | W | singleThread: true 与 forks pool 共用（禁用并行） |  
| P2 | 性能 | W | isolate: false 无注释（测试隔离风险） |  
| P3 | 性能 | I | 无 pool 配置（默认可能非最优） |  
| P4 | 性能 | W | globals: true 未引用类型声明 |  
| C1 | 兼容性 | W | 使用已废弃选项 |  
| C2 | 兼容性 | W | css.modules 未配 css.include（可能遗漏） |  
| C3 | 兼容性 | W | deps.inline 与 deps.external 冲突 |  
| B1 | 最佳实践 | I | 未配置 reporter |  
| B2 | 最佳实践 | I | 缺失 coverage 配置 |  
| B3 | 最佳实践 | W | setupFiles 引用的模式可能不存在 |  
| B4 | 最佳实践 | I | 未显式配置 snapshotFormat |  
| B5 | 最佳实践 | I | 未设置 passWithNoTests（空测试套件 CI 可能失败） |  
输出格式

text（默认）：人类可读，前缀 [E]/[W]/[I]


json：机器可读结构化输出

summary：单行 PASS / WARN / FAIL

`退出码`

0 — 无错误

1 — 发现错误（或 --strict 模式下警告）

2` — 文件未找到或解析失败

数据来源：ClawHub ↗ · 中文优化：龙虾技能库