Claude Code 仓库实战用 /dedupe 命令与多 Agent 并行协作自动发现 GitHub 重复 Issue【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-codeClaude Code 是运行在终端中的 Agent 化编码工具可以通过自然语言完成代码理解、git 工作流与日常维护任务。本文聚焦 .claude/commands/dedupe.md 这一自定义斜杠命令完整拆解其多 Agent 并行搜索 结果过滤 自动评论的 Issue 去重流水线并深入到本仓库 scripts 目录下 gh.sh、comment-on-duplicates.sh 等配套脚本的源码实现帮助读者掌握如何为开源项目构建一套可落地、可约束、可自动闭环的重复 Issue 治理方案。一、命令入口dedupe.md 的 frontmatter 与职责边界该命令文件本身位于仓库的 .claude/commands/dedupe.mdClaude Code 会将.claude/commands/目录下的 Markdown 文件注册为斜杠命令。文件头部通过 YAML frontmatter 声明了两项关键元数据--- allowed-tools: Bash(./scripts/gh.sh:*), Bash(./scripts/comment-on-duplicates.sh:*) description: Find duplicate GitHub issues ---description命令的简短描述用于在命令列表与提示词上下文中向模型说明用途。allowed-tools权限约束的核心。它声明本命令运行期间只允许调用 scripts/gh.sh 与 scripts/comment-on-duplicates.sh 这两个 Bash 工具*表示允许任意参数。这正是后面只准用受控脚本操作 GitHub约束在机制层面的落地——模型被限制在一个受信任的、经过白名单过滤的工具面上工作。二、五步去重工作流从摘要到评论的完整链路命令正文给出了一个必须严格按序执行的五步流程其核心思想是用并行 Agent 搜候选 → 独立 Agent 滤噪声 → 脚本落评论的方式把人工排查重复 Issue 的工作交给多个 Agent 协同完成Step 1 —— 前置筛选决定是否继续启动一个 Agent 检查目标 Issue 是否满足以下任一条件满足则立即终止该 Issue 已经关闭不需要去重例如属于没有具体解决方案的宽泛产品反馈或正面反馈该 Issue 上已经存在此前由你发布的 duplicates 评论。这一步避免了对无需处理的 Issue 做无谓搜索也防止重复评论刷屏。Step 2 —— 生成问题摘要用 Agent 查看目标 Issue并要求其返回一份问题摘要。摘要将作为后续并行搜索的种子查询因此摘要质量直接影响召回效果。Step 3 —— 5 个并行 Agent 多路搜索基于 Step 2 的摘要同时启动 5 个 Agent 搜索该 Issue 的重复项要求它们使用多样化的关键词与不同的搜索策略。并行 多路的意义在于单个搜索词的召回往往不完整不同表述错误信息原文、功能名、复现步骤特征等能互相补足提高命中率。Step 4 —— 独立 Agent 过滤误报把 Step 1 与 Step 3 的结果交给另一个 Agent 做二次过滤剔除看似相关实则不是重复项的假阳性false positives。如果过滤后已无重复项则不继续。这一环节相当于在召回之后补了一道精排避免把无关 Issue 误标为重复。Step 5 —— 脚本发布评论若仍存在重复项则调用评论脚本发布结果命令原文给出的调用方式为./scripts/comment-on-duplicates.sh --potential-duplicates dup1 dup2 dup3值得注意的是命令标题中的up to 3即最多汇报 3 个疑似重复项这与 scripts/comment-on-duplicates.sh 中最多接受 3 个的硬性校验完全对应详见下文。三、受控 GitHub 交互层gh.sh 的源码级约束命令反复强调与 GitHub 交互必须使用 scripts/gh.sh而不是直接 web fetch 或裸gh命令。该脚本是一个只允许特定子命令与特定 flag的安全包装器从源码可以看到它的约束是多层的3.1 仓库作用域强制绑定脚本开头强制要求设置GH_REPO或GITHUB_REPOSITORY环境变量且必须是owner/repo格式否则直接报错退出REPO${GH_REPO:-${GITHUB_REPOSITORY:-}} if [[ -z $REPO || $REPO */*/* || $REPO ! */* ]]; then echo Error: GH_REPO or GITHUB_REPOSITORY must be set to owner/repo format ... 2 exit 1 fi export GH_REPO$REPO所有后续gh调用都通过--repo $REPO显式绑定到该仓库确保 Agent 无论如何都不可能操作仓库之外的对象。3.2 子命令白名单脚本只放行 4 种子命令组合其余一律拒绝case $CMD in issue view|issue list|search issues|label list) ;; *) echo Error: only issue view, issue list, search issues, label list are allowed ... 2 exit 1 ;; esac3.3 flag 白名单与参数形态校验可用的 flag 只有--comments、--state、--limit、--label其中--state、--limit、--label需要携带值。脚本在解析参数时会校验每个 flag 是否在白名单内并正确处理--flag value与--flagvalue两种写法。此外还有针对各子命令的位置参数形态校验search issues查询串中不允许出现repo:、org:、user:限定符防止 Agent 把搜索范围引到仓库之外issue view必须且只能传一个纯数字的 Issue 编号issue list/label list不允许传位置参数。这些校验共同保证了Agent 能做的操作被压缩到查看/列表/搜索/标签四类只读或半只读操作且全部锁定在当前仓库内。命令正文还给出了四个标准用法示例均可直接套用./scripts/gh.sh issue view 123 # 查看某个 Issue ./scripts/gh.sh issue view 123 --comments # 查看 Issue 及其评论 ./scripts/gh.sh issue list --state open --limit 20 # 列出开放的 Issue ./scripts/gh.sh search issues query --limit 10 # 搜索 Issue四、评论落盘comment-on-duplicates.sh 的校验与文案scripts/comment-on-duplicates.sh 是流水线的最后一公里负责把去重结论以评论形式发布。源码揭示了它的完整行为4.1 参数与基线 Issue 解析仅接受--potential-duplicates一个参数且其后可跟 13 个数字形式的 Issue 编号超限、非数字、缺参都会报错退出基线 Issue 编号不来自命令行而是从GITHUB_EVENT_PATH指向的 workflow 事件负载中读取jq -r .issue.number // .inputs.issue_number即评论目标是触发事件的那个 Issue天然避免了 Agent 传错编号的问题。4.2 存在性校验发布前脚本会用gh issue view逐一确认基线 Issue 与每个疑似重复 Issue 都存在任何一条不存在都会中止防止把评论发到不存在的编号上。4.3 评论正文模板评论内容由脚本生成格式固定便于后续自动化脚本识别Found N possible duplicate issues: 1. https://github.com/owner/repo/issues/dup ... This issue will be automatically closed as a duplicate in 3 days. - If your issue is a duplicate, please close it and the existing issue instead - To prevent auto-closure, add a comment or this comment Generated with Claude Code注意其中两处关键设计文案预告3 天后自动关闭并给出点赞同意 / 评论或点踩反对的互动机制每条重复项都带完整的 Issue URL而 scripts/auto-close-duplicates.ts 正是靠解析这条评论来提取重复编号的。五、自动闭环从评论到 3 天后自动关闭去重流程并不止于发评论。scripts/auto-close-duplicates.tsBun 脚本定期扫描所有开放 Issue寻找由机器人发布的去重评论并据此执行自动关闭其判定条件层层递进识别去重评论评论正文同时包含Found与possible duplicate且作者类型为Bot只处理 3 天前的评论评论时间早于now - 3 days才进入候选给社区留出 3 天申诉窗口无后续活跃去重评论之后不允许再出现新评论有后续讨论则跳过作者未反对检查评论上的 reactions若 Issue 作者本人对去重评论点了 content -1则视为作者不同意跳过关闭解析重复编号用正则从评论中提取#123或github.com/.../issues/123形式的编号执行关闭通过 GitHub API 将 Issue 状态改为closed、state_reason置为duplicate、打上duplicate标签并追加一条已作为 #N 的重复项自动关闭的说明评论。从源码结构看这套发评论 → 3 天等待 → 无反对即关闭的机制正是 dedupe.md 评论文案中3 天承诺的实现方。仓库内还有 scripts/backfill-duplicate-comments.ts 用于按 Issue 编号区间默认14050可被MIN_ISSUE_NUMBER/MAX_ISSUE_NUMBER环境变量覆盖回刷历史 Issue为尚未跑过去重的存量 Issue 补触发claude-dedupe-issues.yml工作流它默认以DRY_RUNtrue运行并会在每次触发之间延时 1 秒避免打爆 API。六、与其它治理脚本的分工dedupe 在 Issue 生命周期中的位置dedupe 并不是孤立存在的。仓库 scripts 目录下的其它脚本共同构成了完整的 Issue 生命周期治理体系scripts/issue-lifecycle.ts 是生命周期标签的单一事实来源定义了invalid3 天、needs-repro7 天、needs-info7 天、stale14 天、autoclose14 天五类标签各自的超时天数、原因与提示文案scripts/lifecycle-comment.ts 在生命周期标签被应用时依据上表的nudge文案自动给作者发一条说明原因 预告自动关闭的提醒评论.claude/commands/triage-issue.md 是配套的 Issue 分诊命令同样通过 scripts/gh.sh 与 scripts/edit-issue-labels.sh 完成标签分类与 dedupe 命令共享同一套受控脚本体系。从这一分工可以看到 dedupe 的定位它解决的是这个 Issue 是否与已有 Issue 重复这一特定问题输出物是一份带 3 天自动关闭承诺的评论而标签治理解决的是这个 Issue 是否信息完备、是否还活跃的问题。两者互补共同维持 Issue 列表的整洁。七、可直接复用的落地要点综合命令文档与源码这套方案可以在你自己的开源仓库中直接迁移复用核心要点如下用受控脚本层代替裸工具仿照 scripts/gh.sh 写一个只放行必需子命令、强制绑定owner/repo作用域、严格校验 flag 与位置参数的包装脚本并在命令 frontmatter 的allowed-tools中声明从源头限制 Agent 的能力面搜索与判断分离摘要生成、并行搜索、误报过滤分别由不同 Agent 承担避免单一 Agent 既当搜又当判带来的偏置评论即协议让去重评论格式固定、机器可解析后续自动关闭脚本才能可靠地从评论中提取编号与判断作者态度给人类留出否决通道3 天等待期 作者 即跳过 后续评论即跳过确保自动流程可以被社区低成本推翻先建 todo 再执行命令原文特别要求Make a todo list first让长流程在任务列表中可见、可控、可中断。这套Claude Code 斜杠命令 多 Agent 并行 受控脚本的组合把开源维护中最耗时、最容易被误判的重复 Issue 治理变成了一个可重复、可审计、可自动闭环的标准流程值得在任意活跃仓库中借鉴实践。【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考