用途:Codeguard 是代码质量门禁的主入口与路由中心,把“看起来没问题”变成有命令、范围、版本和退出码的可重复证据。适用于识别仓库语言、执行 lint/格式门禁、受控修复、CVE 扫描,以及在 commit/push/release 前需要证据化质量结论的场景。
主要能力:项目语言自动检测(扩展名加标记文件双重识别);统一 lint 门禁 bin/codeguard check(或 scripts/run_check.py),失败退出码 2;统一自动修复 bin/codeguard fix(spotless / cargo fmt / eslint --fix / ruff --fix),仅 Legacy 引擎可用;CVE 依赖漏洞编排 bin/codeguard cve(Maven dependency-check / npm audit / pip-audit / cargo audit);提交门禁与会话总结钩子。
使用方式:先判定引擎 codeguard --version --format json,再检测语言 python3 "${CLAUDE_PLUGIN_ROOT}/scripts/detect_lang.py" "$(pwd)",然后执行 bin/codeguard check,失败后 bin/codeguard fix --lang <name> 并复扫,提交前运行 bin/codeguard cve --severity HIGH。Rust 引擎改用位置参数(check all|java、cve <rust|python|typescript>),且 fix、--lang、--ecosystem、--severity 均不存在。
限制:需各语言工具链已安装,缺失时报告“无法验证”而非通过;Redis 仅安全钩子需要。lint 失败即阻塞,无法验证或未完成不等于通过,禁止静默豁免。语法学习、框架用法、库选型、分支命名、commit 格式、密钥/CVE、越权鉴权、加密脱敏等应路由到对应专用技能。本技能不收集、上传或存储用户源码和凭据,默认只读路由。