用途:把 Terraform / OpenTofu 项目的“看起来没问题”变成可重复的工具证据,并诚实区分 PASS、FAIL、UNVERIFIED、PLANNED 四种状态。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 tflint 相关失败的场景。
主要能力:根据 .tf、.tfvars、.tofu 识别工作区;执行 tflint 并保留退出码、作用域与工具版本;区分格式、静态规则、配置、环境、工具内部错误五类失败;用 terraform fmt 处理可逆问题并复扫;把 lint、format、compile、test、security 证据分层汇报。
使用方式:先在仓库或模块根确认目标文件,探测工具 tflint --version,先只读运行 tflint,再仅对可安全修复项执行 terraform fmt,随后复跑同一 lint 命令并运行项目已有测试与构建。工具缺失可用 brew install tflint 准备。
适用与限制:需工具已安装且版本兼容,须在正确仓库或模块根执行,以已提交配置为准,扫描范围遵循仓库规则。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore 掩盖问题;工具缺失或配置缺失时不得声称通过,应标 UNVERIFIED。不收集、上传或存储代码与凭据,仅本地读取与运行。
更多细节(如门禁规则、工具链核对、任务示例)按需读取 references 与 examples 目录。状态为 stable(自 Codeguard V0.3);项目无专用标记文件。