cpplint 静态检查

对仓库执行 cpplint,入口与参数同 CI 的 lint 门禁 (.github/scripts/ci-lint.sh)中 "Run cpplint" 步骤。不锁定 cpplint 版本,使用当前环境中可用的版本。

1. 执行

先检查 cpplint。缺失时停止并询问是否允许 pip install --user;未经 确认不得直接运行会自动安装依赖的 tools/check.sh。

REPO_ROOT="$(git rev-parse --show-toplevel)"
export PYTHONPYCACHEPREFIX="$REPO_ROOT/build-ai/skill_check/__pycache__"
command -v cpplint
cpplint --version
bash "$REPO_ROOT/tools/check.sh" "$REPO_ROOT"

脚本行为:

• 扫描所有 .h/.hpp/.cc/.cpp(自动排除根 tools/、thirdparty/、 build/、build-*/、builtin/、prebuilt/、android-bp/)。
• cpplint --counting=detailed --linelength=120,过滤集已禁用: build/c++17、build/include*、runtime/references、 readability/check、readability/braces、readability/nolint、 whitespace/indent_namespace。
• 末尾统计总代码行数。

2. 结果处理

• 有告警时逐条报告;用户同时要求修复时再修改源码。禁止通过在脚本 过滤集里追加条目来消音(过滤集由维护者统一治理)。误报的处置遵循 .agents/languages/CPP.md 第 11 节的既定习惯。
• tools/check.sh 在依赖缺失时会安装 cpplint,因此必须完成上述确认。 已安装任意版本均可直接执行,不得因版本与其他环境不同而阻塞检查。
• 执行依赖检查、安装和 cpplint 期间保持上述 PYTHONPYCACHEPREFIX,不得在源码树生成 __pycache__。
• 执行前记录 cpplint --version。
• 本 skill 只跑 cpplint;clang-tidy 检查用 /clang-tidy,格式化用 /format。