用途:对 Zig 项目执行代码规范门禁,先做只读检查,再按需受控修复,并诚实区分为通过、失败、无法验证和 planned。适用于新改 .zig 文件的提交前验证、CI 出现与 zig fmt --check . 相关失败,以及判断某问题能否自动修复。
主要能力:识别 Zig 工作区(.zig 与 build.zig 等项目标记);运行 zig version 探测工具;执行 zig fmt --check . 并保留退出码、作用域与工具版本;区分格式、静态规则、配置、依赖与环境类失败;用 zig fmt 处理可逆问题并复扫;把 lint 与 CI、构建、测试证据分层汇报。
必要用法:确认仓库根或模块根以及 build.zig 或目标文件存在;运行 zig version;先只读执行 zig fmt --check .;仅对可安全修复项运行 zig fmt;修复后复跑同一 lint 命令,并按项目已有测试与构建门禁验证。输出可按“范围/工具/命令/状态/发现/修改/复验/未验证”模板汇报。
限制:目标工具须已安装且版本与项目约束兼容,须从正确仓库或模块根执行;不自查依赖漏洞、安全审计或许可证治理;不静默安装工具、升级依赖或改动团队规则;不用 ignore、suppress 或调高阈值掩盖问题;缺少工具、配置或未运行时不得声称通过。formatter 通过不代表编译、测试或安全审计通过;本地通过也不等于 CI 通过。自动修复前先检查 diff,破坏性或大范围修改需用户明确确认。本技能不收集、上传或存储用户代码与凭据,默认只读本地配置并运行本地工具。