用途:把 Perl 项目的代码规范检查变成可重复的工具证据。适用于用户要求 lint、格式检查、自动修复或提交前质量验证,以及 CI 出现 perlcritic '{file}' 相关失败时。
主要能力:按 .pl、.pm、.t 与项目标记识别 Perl 工作区;执行 perlcritic '{file}' 并保留退出码、作用域与工具版本;区分格式、静态规则、配置、依赖与环境类失败;用 perltidy -b '{file}' 处理可逆问题并复扫;将 local 结果与 CI/构建/测试证据分层汇报。
使用方式:在仓库根确认项目标记或无专用标记文件以及目标文件;探测 perlcritic --version;先只读执行 perlcritic . ;再按失败分型处理,仅对可安全修复项运行 perltidy -b '{file}';最后复跑同一 lint 命令并运行项目已有测试与构建。工具准备命令 cpanm Perl::Critic Perl::Tidy。项目级 gate 为 perlcritic . 。
适用场景:提交前验证 AI 修改过的 Perl 文件、判断某个问题能否自动修复、解释 perlcritic 失败类型。
限制与边界:不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;工具缺失或配置无法加载时记为 UNVERIFIED,不声称通过。执行需遵循仓库已有配置与扫描范围,生成与 vendor 目录策略须遵循仓库规则。状态为 stable(自 Codeguard V0.5)。