用途:ContextLevy CLI 是仓库卫生检查工具,帮助重度使用编码智能体的团队识别会让智能体审查变嘈杂的 diff,例如生成输出、覆盖率文件、构建产物、锁文件变动和智能体指令变更。隐私方面,它不调用 LLM、不上传代码、不使用外部 API,完全在本机运行。若需 GitHub PR 评论,应使用 contextlevy 技能。
安装:需要 Node.js 20+ 且 git 在 PATH 中。全局安装命令为 npm install -g contextlevy。也可通过 npx skills add nonlooped/contextlevy 安装技能,向导可选择 contextlevy-cli、contextlevy 或两者;仅安装本技能用 --skill contextlevy-cli。
主要命令:npx contextlevy check --base main 为无需配置的起点;npx contextlevy scan 对已跟踪文件做仓库级基线;npx contextlevy init --full 生成配置、工作流和 pre-push 钩子;npx contextlevy fix 默认试运行建议忽略模式,加 --write 写入;npx contextlevy badge --style debt 或 --from check --style risk 生成 README/PR 徽章;npx contextlevy hook install 安装钩子,可加 --pre-commit --no-pre-push。check 支持 --staged 仅看暂存、--format json 输出 JSON、--fail-on-config 应用配置失败设置、--strict 严格类别门禁。
退出码:0 表示低于失败阈值,1 表示超过失败阈值,2 表示用法、配置或 git 错误。
配置:在仓库根添加 contextlevy.config.yml。关键项包括 token-threshold(默认 1000)、fail-on-severity、fail-above-tokens、ignore-paths、allow-paths、estimation-mode(simple 为字符数÷4,或 tokenizer 本地 BPE)、comment-format。
标记类别:覆盖率、生成文件、构建输出、锁文件、智能体配置、大文件。
限制:仅分析 git diff 可见的已跟踪改动,新文件需 git add 或使用 --staged;scan 和 fix --from scan 使用 git ls-files 做仓库级基线;与 GitHub Action 复用同一配置和估算模式。更多配置表、严重级别和配方见 reference.md 与 CONFIG.md。