用途:对 Codeguard 支持的仓库执行只读 lint 门禁并解释结果。适用于用户要求跑 lint、检查代码规范、提交前自检,CI 报告 Codeguard/linter 失败需本地复现,或跨语言仓库需统一结果摘要时。
主要能力:自动检测项目语言并一次跑多语言 lint;表格化报告每种语言的命令、退出码、耗时和状态;区分代码违规、配置错误、工具缺失、未完成和执行器错误;为修复与 CI 复现产出结构化证据。
使用方式:先判定引擎(codeguard --version --format json),再选命令面。Legacy Python 引擎可用 bin/codeguard detect .、bin/codeguard check .、bin/codeguard check --lang java,python --timeout 60 .;Rust 组件用 codeguard detect . --format json、codeguard plan check all .、codeguard check all . --format json。Rust 侧 check 只接受位置参数 all|java,无 --lang,--timeout 接受 duration 如 30m,退出码 3 表示未完成。实际参数以 bin/codeguard check --help(Legacy)或 codeguard --help(Rust)为准。
标准流程:确定范围、识别语言、核对仓库与 CI 权威命令、探测工具版本、执行只读检查、分类失败、按语言输出结果。执行前记录工作目录、当前分支、目标模块和工具版本,并写明结果由哪个引擎签发。若 bin/codeguard 不存在,不要猜测命令或声称通过,改用仓库权威 CI/lint 命令或报告 UNVERIFIED。
状态语义:PASS 为权威检查命令在明确范围退出 0;FAIL 为工具成功运行并发现违规;UNVERIFIED 为工具、配置、权限、版本、超时或环境不足;INCOMPLETE 为按契约未跑完(Rust 退出码 3、必需检查缺失、部分模块未覆盖);PLANNED 为注册表仅有识别能力,没有可执行门禁。
限制:不自动修复(交给 codeguard-fix),不做 CVE 扫描(交给 codeguard-cve);不把 lint 通过扩大为编译、测试、安全或发布通过;不在检查任务中修改 ignore、suppression 或规则阈值;不适用语法或框架设计问题、依赖漏洞、凭据泄露或数据合规,也无法在没有仓库上下文时证明整仓全绿。工具缺失、超时和配置错误不等于通过,同一结论须带命令、范围和退出码,检查阶段不修改用户文件,不用一种语言的通过掩盖另一种语言的失败。本技能不收集、上传、发送或存储用户源码与凭据,默认只读执行本地工具。技能包只提供操作知识,不包含 Codeguard 运行时。