clawpatch - 仓库切片化代码审查 + 自动修复

技能简介

clawpatch 是一款把代码审查、缺陷修复、PR 发布整合成一体的 AI 编程助手 CLI。它先把仓库拆分成"语义 feature 切片"，再让本地安装的 Claude Code / Codex / Cursor 等编程 Agent 对每个切片做 bounded review，结构化记录 finding（带证据、可回溯），最后基于 finding 触发 patch → revalidate → open-pr 的完整闭环。所有状态持久化在 .clawpatch/ 目录，中途断网、token 限额耗尽、agent 报错都不会丢失进度，下次 resume 即可接着干。GitHub 800+ 星、Node 22+ 即跑，主打"review by feature, fix by finding"的工程化体验，适合中小团队用 AI 替代部分 reviewer 工作量。

核心能力

• 仓库切片化（Feature Mapping）：默认 mapper 解析 Node.js/TypeScript、Python、Ruby、PHP、Go、Rust、C/C++、Java/Kotlin、.NET、Swift 项目，按 manifests、框架约定、路由、package、target、test、相邻 context 切出可审查的 feature 切片，跳过 generated 目录与符号链接。
• 多 Agent Provider 适配：以 CLI 形式对接本地已登录的 Claude Code / Codex / Cursor / Aider 等编程 Agent；用户无需在 clawpatch 里二次配置 API key，复用已有订阅。
• Bounded Parallel Review：clawpatch review --limit N --concurrency N，并发调用 Agent 审查多个切片，单次 review 受 token 上限保护避免爆预算。
• Evidence-backed Findings：每个 finding 持久化在 .clawpatch/findings/.json，包含原始 diff、模型输出、严重等级、复现路径，reviewer 可随时用 clawpatch show 回看证据。
• Apply Patch + Revalidate：clawpatch fix --finding 让 Agent 重新激活并写出修复，运行配置的 lint / test / typecheck；revalidate --finding 再跑一次确认问题已消解。
• PR 直发：clawpatch open-pr --patch 把记录在案的 patch 文件 commit、push、开 PR；CI 可在 PR 阶段调用 clawpatch ci --since origin/main 做只读再审。

安装配置

• 环境要求：Node.js 22+、Git 仓库、至少一个已登录的 AI 编程 CLI（Claude Code、Codex、Cursor、Aider 等任选其一）。
• 全局安装：pnpm add -g clawpatch（推荐）或 npm install -g clawpatch，命令名 clawpatch。
• 项目初始化：在 Git 仓库根目录执行 clawpatch init，自动写入 .clawpatch/config.yaml，包含 provider 选择、并行度、review token 上限、CI 命令模板。

使用步骤

1. 环境诊断：clawpatch doctor，检查 Node 版本、git 状态、已安装 provider CLI、API key 是否可用，发现缺项即时提示。
2. 仓库切片化：clawpatch map，把仓库切成语义 feature 记录，存到 .clawpatch/map.json；可用 --source auto 或 --source agent 让 Agent 介入辅助切片。
3. 首批 review：clawpatch review --limit 3，并发审查前 3 个切片；进度走 stderr，findings 写磁盘。
4. 查看报告：clawpatch report 输出当前批次 finding 汇总；clawpatch next 智能推荐下一批高优切片；clawpatch show 查看单条 finding 证据。
5. 触发修复：clawpatch fix --finding，让 Agent 写出修复 diff 并跑配置的 lint / test / typecheck，结果写入 .clawpatch/patches//。
6. 复验：clawpatch revalidate --finding，对当前代码再跑一次对应审查，确认 finding 已消解。
7. 开 PR：clawpatch open-pr --patch，把 patch 文件 commit 到新分支、push、调用 gh pr create 开 PR；CI 流程可挂 clawpatch ci --since origin/main --output clawpatch-report.md 做只读再审。

适用场景

• 个人项目自查：独立开发者在 push 前对 feature 分支跑一次切片化 review，挡掉低级缺陷后再开 PR。
• 小团队 PR 流水线：3-10 人团队缺乏专职 reviewer，让 clawpatch 在 CI 中对每个 PR 自动出 finding 报告，reviewer 只需看高严重等级项。
• AI 编程 Agent 质量门：Claude Code / Codex 跑出大量 PR 后，用 clawpatch 做统一 review 与自动修复，避免单 agent 输出良莠不齐。
• OSS 维护者批量 triage：开源项目一次性接收大量 PR，用 clawpatch 把每个 PR 切成 feature、批量生成 finding 列表，再人工抽检。
• 重构期安全网：大型 refactor 中，每个改动都过一遍 review + revalidate 流程，避免引入新缺陷。
• 多语言 monorepo：Node.js + Python + Go + Java 混合 monorepo 的一次性 review，无需为每种语言接独立工具。

适用人群

• 独立开发者与小团队 Tech Lead（无专职 reviewer，AI 兜底）
• AI 编程 Agent 重度用户（Claude Code / Codex / Cursor 用户）
• 开源项目维护者（批量 PR triage）
• 平台工程 / DevOps（CI 流水线审查自动化）
• 多语言 monorepo 维护者

工作原理

clawpatch 由三阶段管道组成：Map → Review → Fix。Map 阶段用确定性解析器（manifests、框架约定、test、route、package）把仓库切分为 feature 切片，写入 .clawpatch/map.json；Review 阶段并发调用本地 CLI 形式的 Claude Code / Codex / Cursor，每个 Agent 拿到 bounded prompt（含切片路径、上下文、相关历史 findings），输出结构化 finding（severity、evidence、reproduction）落到 .clawpatch/findings/；Fix 阶段激活 Agent 写 patch（同样 bounded），跑配置的 validate commands，把 diff 存到 .clawpatch/patches//，再用 revalidate 命令让 Agent 对照原始 finding 二次确认。所有阶段支持 resume，且每一步都被显式记录，保证审查与修复过程可回溯、可解释。

官方链接

• npm 包：https://www.npmjs.com/package/clawpatch
• GitHub 仓库：https://github.com/openclaw/clawpatch
• 官方主页：https://clawpatch.ai
• 快速上手文档：https://github.com/openclaw/clawpatch/blob/main/docs/quickstart.md