SuperAPI AI 工具集

codeguard-luau

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:对 Luau 项目执行并诊断代码规范门禁,适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或出现 luau-analyze '{file}' 相关失败时。核心原则是把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。

主要能力:根据 .luau 扩展名与项目标记识别 Luau 工作区;执行 luau-analyze '{file}' 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖和环境类失败;使用 stylua --syntax luau . 处理可逆问题并复扫;把本地结果与 CI、构建、测试证据分层汇报。

使用方式:先确认仓库根、模块根、生成目录、vendor 目录和用户指定文件,读取仓库现有配置与 CI 中的实际命令;探测工具版本,如 luau-analyze --version;执行只读检查 bash -c 'find . -name '"'"'*.luau'"'"' -type f -print0 | xargs -0 -r luau-analyze';对可安全修复项运行 stylua --syntax luau .;修复后必须复跑触发失败的原命令,再运行项目已有测试与构建。输出按范围、工具、命令、状态、发现、修改、复验、未验证分层报告。

适用场景:检查或修复 Luau 代码规范;AI 修改 .luau 后的提交前验证;CI 出现 luau-analyze 相关失败;判断问题能否自动修复或需人工处理。

限制:目标工具必须已安装且版本兼容,必须从正确仓库或模块根目录执行,项目自定义配置优先。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;缺少工具或配置时不得声称检查通过。不适用于语言语法学习、框架设计、业务建模、依赖漏洞、安全审计或许可证治理。本技能不收集、上传、发送或存储用户代码和凭据,默认只读取本地仓库配置并运行本地工具,不联网安装依赖。