用途:把 Lua 项目的代码规范检查变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 luacheck . 相关失败时。
主要能力:根据 .lua 文件识别 Lua 工作区;执行 luacheck . 并保留退出码、作用域与工具版本;区分格式、静态规则、配置、依赖和环境类失败;用 stylua . 处理可逆问题并复扫;把本地结果与 CI/构建/测试证据分层汇报。
使用方式:在仓库根确认目标文件存在;探测工具 luacheck --version;先只读检查 luacheck .;将结果分为代码违规、配置缺失、工具缺失、工具内部错误;只对可安全修复项执行 stylua .;复跑 lint 并执行项目已有测试/构建门禁。工具准备命令为 luarocks install luacheck; cargo install stylua。
限制:目标工具须已安装且版本兼容,须从正确仓库或模块根目录执行,以已提交配置为准。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore 掩盖问题;缺少工具或配置时不得声称检查通过。工具缺失应输出 UNVERIFIED。本技能不收集、上传或存储用户代码与凭据,默认只读本地配置并运行本地工具,不联网安装依赖。自动修复前先检查 diff,破坏性或大范围修改须用户明确确认。
输出状态分为 PASS / FAIL / UNVERIFIED / PLANNED,并分别报告 lint、format、compile、test、security 证据。