用途:把 C 项目的代码规范检查变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。适用于用户要求 lint、格式检查、自动修复、提交前验证,或 CI 出现 clang-tidy --quiet '{file}' 相关失败时。
主要能力:根据 .c、.h 与项目标记识别 C 工作区;执行 clang-tidy --quiet '{file}' 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖与环境类失败;用 clang-format -i '{file}' 处理可逆问题并复扫;把本地结果与 CI、构建、测试证据分层汇报。
使用方式:先确认仓库根与目标文件,探测 clang-tidy --version;只读检查可运行 bash -c 'find . -name '.c' -o -name '.h' | xargs -r clang-tidy --quiet';将结果分为代码违规、配置缺失、工具缺失、工具内部错误;仅对可安全修复项执行 clang-format -i '{file}',随后复跑 lint 并执行项目已有测试与构建门禁。项目级 gate 命令同上。
适用场景:检查或修复 C 代码规范;AI 修改 .c、.h 后的提交前验证;CI 中 clang-tidy 相关失败诊断;判断问题能否自动修复或需人工处理。
限制:目标工具须已安装且版本兼容,须从正确仓库或模块根执行,以已提交配置为准。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore 掩盖问题;缺少工具或配置时不得声称检查通过。工具缺失应记为 UNVERIFIED。本技能不收集、上传或存储用户代码与凭据,默认只读本地配置并运行本地工具,不联网安装依赖。复杂项目建议提供 compile_commands.json。