用途:这是一个基于 clawpatch 的缺陷发现与筛查流程,最终交付物是 docs/bugs/ 下的精选 markdown 文件。触发词为“run clawpatch”“clawpatch bug hunt”“scan for bugs”。
主要能力与流程分两阶段。第一阶段生成原始报告:先 rm -rf .clawpatch 清空工作区,用 date +%Y-%m-%d 取当天日期并 mkdir -p docs/bugs,然后依次执行 clawpatch init、clawpatch map、clawpatch review --limit 20(前台运行,只显示一行状态),最后 clawpatch report > docs/bugs/${DATE}-bugs.md。若任一命令非零退出,需停止并向用户展示 stderr,不得基于不完整报告进入第二步。
第二阶段研判:读取原始报告,解析每条 finding(标题、文件引用、clawpatch 理由),为每条 finding 并行启动一个 Explore 或通用子代理,提示词需自包含,粘贴 finding 原文,要求返回“VERDICT: real-bug | not-a-bug | low-value”加 2–4 句带 path:line 的证据。汇总后保留 real-bug,丢弃 not-a-bug 与 low-value 并简述原因;保留项按 P0(阻断发布)、P1(真实面向用户、可恢复)、P2(打磨/纵深防御/边缘情况)三档排序,桶内按影响从高到低,并重新编号 1..N,不保留 clawpatch 输出顺序。
输出结构:docs/bugs/${DATE}-bugs-serious.md,包含标题、来源说明、保留/丢弃数量、优先级说明,以及 P0、P1、P2 各分节(每条含 Where、What clawpatch said、Why it is real、Suggested fix sketch)和 Dropped 列表。完成后告知用户文件位置、保留/丢弃数及三档分布。
限制:全程不修改应用代码,仅写 docs/bugs/ 下文件;不得跳过 Step 0;不得对无关目录运行 clawpatch,须在仓库根目录调用;子代理提示词必须自包含;当天已有同名文件时直接覆盖。用户 PATH 上已装好 clawpatch,不要尝试安装。资料未提供 clawpatch 的收费、平台或更多细节。