用途:以编程方式检查代码风格,作为代码风格规则的自动化补充,而非替代。通过 AST 分析而非正则实现格式无关、语义准确的检查。
主要能力:检查命名规范(变量/函数 camelCase 或 snake_case、类 PascalCase、常量 UPPER_CASE、私有成员加下划线前缀)、缩进(JS/TS 2 空格、Python 4 空格)、导入顺序(外部、内部、相对)、函数/类结构、注释风格。可用于提交前钩子与 CI。
使用方式:无需单独下载,脚本会自动调用仓库内 .claude/tools/cli/security-lint.cjs;需先安装 Node.js v18+(Windows: winget install OpenJS.NodeJS.LTS,macOS: brew install node)。建议在 pre-commit 与 CI 中运行,配合 --fix 自动修复可修复项。示例命令:node validate-code-style.js src/components/Button.tsx(单文件)、node validate-code-style.js src/components/(目录,均为实现校验器后的模板)。输出含 file、valid、issues(行、列、rule、message、severity)与 summary。
原则与限制:始终优先使用 AST 工具(ESLint/Prettier)而非正则;写自定义规则前先查现成规则;仅对错误阻断提交,警告只记录;提供自动修复建议;同时在 pre-commit 和 CI 运行。文中大量命令、钩子与工作流均为需先自行实现校验器的模板,非开箱即用;内置脚本名为 security-lint,与风格校验的关系暂未提供更多说明。