用途:在 Visual Basic .NET 仓库中执行代码规范门禁,把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned(计划中)。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现与 dotnet format --verify-no-changes 相关失败时。
主要能力:根据 .vb 文件与项目标记识别 VB.NET 工作区;执行 dotnet format --verify-no-changes 并保留退出码、作用域与工具版本;区分格式、静态规则、配置、依赖与环境类失败;对可逆问题用 dotnet format 修复并复扫;把 lint、format、compile、test、security 证据分层汇报。
使用方式:在仓库根确认目标文件存在,探测 dotnet --version,先只读检查 dotnet format --verify-no-changes,按失败类型分类,仅对可安全修复项执行 dotnet format,然后复跑原命令并执行项目已有测试与构建。输出模板包含范围、工具版本、实际命令、状态(PASS/FAIL/UNVERIFIED/PLANNED)、发现分类、修改、复验与未验证项。
限制:目标工具须已安装且版本与项目约束兼容,须从正确仓库或模块根执行,以已提交配置为准。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore 掩盖问题;缺少工具或配置时不得宣称“检查通过”。formatter 不是 linter,格式全绿不能覆盖静态规则或编译错误;生成代码与 vendor 目录是否扫描须遵循仓库规则。
数据与安全:不收集、上传、发送或存储用户代码与凭据,默认只读取本地仓库配置并运行本地工具,不联网安装依赖,不记录 token、密码或私有源码;自动修复前先检查 diff,破坏性或大范围修改须用户明确确认。状态:stable(自 Codeguard V0.4)。