适用于 Openclaw 的 TSConfig Validator

一个专门的 lint 检查和验证工具,旨在识别 TypeScript 配置文件中的冲突编译选项和严谨性差距。

charlie-morrison
v1.0.1
2026年5月1日
0
798
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install tsconfig-validator

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 tsconfig-validator。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 TSConfig Validator?

TSConfig Validator 是 Openclaw Skills 生态系统中的一个强大实用工具,可确保您的 TypeScript 配置高效、安全且逻辑严密。它超越了简单的 JSON 模式验证,通过分析编译器兼容性、严谨性和组织最佳实践等类别的 22 条特定规则来进行深入分析。

通过集成此技能,开发人员可以自动捕获常见错误,如模块解析不匹配、缺少 out-dirs 或遗忘的 strict 模式标志。它是维护高质量代码库并确保 TypeScript 编译器在不同环境下表现一致的重要保障。

TSConfig Validator 应用场景

  • 审计现有 TypeScript 项目的严谨性差距和缺失的编译器标志。
  • 在 CI/CD 流水中验证 tsconfig.json 文件的结构完整性和 JSON 语法。
  • 检查目标 ECMAScript 版本与所选模块系统之间的兼容性问题。
  • 通过识别缺失的增量编译或 source map 配置错误来提高构建性能。

TSConfig Validator 工作原理

  1. 该技能解析目标的 tsconfig.json 文件,以验证有效的 JSON 语法和结构完整性。
  2. 它运行一套包含 22 条预定义规则的组件,涵盖四个核心领域:结构、严谨性、兼容性和最佳实践。
  3. 验证器识别特定问题,如冲突的 include/exclude 模式或过时的构建目标。
  4. 它以请求的格式(Text、JSON 或 Markdown)生成详细报告,提供可操作的解决建议。
  5. 根据配置,它返回特定的退出代码以发出成功信号或识别关键配置错误。

TSConfig Validator 配置指南

要使用 Openclaw Skills 库中的此工具,请确保已安装 Python 3 并直接针对您的配置文件运行脚本:

# 使用默认设置对配置文件进行 Lint 检查
python3 scripts/tsconfig_validator.py lint tsconfig.json

# 运行针对严谨性的审计
python3 scripts/tsconfig_validator.py strict tsconfig.json

# 仅执行结构验证
python3 scripts/tsconfig_validator.py validate tsconfig.json

TSConfig Validator 数据架构与分类体系

该技能将其发现组织成清晰的基于严重性的分类。结果可以导出用于程序化使用或文档记录:

级别 描述
Error 关键问题,如无效的 JSON 或路径缺少基本 URL,这将导致构建中断。
Warning 潜在的运行时问题、冲突的选项或缺失的严谨性标志。
Info 关于最佳实践的建议,例如启用增量构建或 source maps。

支持的输出格式包括 --format text、--format json 和 --format markdown。

TSConfig Validator 高级特性

  • 多格式报告(JSON/Markdown),可无缝集成到自动化开发工作流中。
  • 通过 --strict 标志强制执行严格模式,该标志会将警告提升为退出代码失败。
  • 针对 JSX、React 和 Node.js 模块解析策略的专门兼容性检查。
  • 对 22 条不同规则进行全面审计,以确保行业标准的 TypeScript 配置。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*