SuperAPI AI 工具集

update-dedupe

编程与开发

查看项目

更新于 11-19 19:51

技能介绍

用途:该技能是一个自我改进循环,专门利用“被关闭为重复问题”(closed-as-duplicate)的维护信号,来更新仓库本地的 dedupe-issue-local 配套技能文件 .agents/skills/dedupe-issue-local/SKILL.md。核心技能 .agents/skills/dedupe-issue/SKILL.md 是跨仓库契约,在本循环中为只读。其他维护信号(重新打标签、重新打开、后续评论)由单独的 update-triage 循环处理,本循环不涉及。

写入范围:本循环只能写入 .agents/skills/dedupe-issue-local/ 目录及其中的 SKILL.md。不得触碰 .agents/skills/dedupe-issue/SKILL.md(核心契约)、.agents/skills/triage-issue-local/SKILL.md(由 update-triage 拥有)或任何其他核心技能。自我改进运行器会在推送前通过 git diff 检查允许的前缀来强制执行此限制,违规将中止运行。

输入:可选仓库覆盖参数(当不在目标检出目录运行时);可选时间窗口覆盖参数(默认回看 7 天)。

工作流:首先验证 GitHub CLI 认证,运行 gh auth status。然后使用捆绑脚本聚合近期关闭问题的重复信号:python3 .agents/skills/update-dedupe/scripts/aggregate_dedupe_feedback.py。默认针对当前仓库并回看 7 天,仅收集 GitHub 自身记录为以 duplicate 关闭原因关闭的问题(state_reason == "duplicate"),并通过问题时间线中的 marked_as_duplicate 事件查找每个问题被关闭所指向的规范问题。仅提及另一个问题的临时维护者评论会被有意忽略,以避免误报。脚本将结构化 JSON 写入临时文件并打印路径。读取生成的 JSON,寻找重复聚类:两个或更多不同报告者提交了相似问题,且维护者将其关闭为同一规范线程的重复;或维护者明确声明某类问题应始终视为某规范线程的重复。提出解释该聚类的最小编辑,在 .agents/skills/dedupe-issue-local/SKILL.md 的“Known-duplicate clusters”章节下添加或更新一条要点,总结规范线程及维护者用于识别重复的区分信号。保持核心去重契约稳定——绝不编辑 dedupe-issue/SKILL.md,绝不削弱 2 候选最小值,绝不更改相似度阈值或输出形状。

证据规则:仅当至少两个独立的关闭为重复事件指向同一规范问题,或维护者明确要求时,才编码一个聚类。没有重复信号时跳过 PR。不要削弱去重中精确率优先于召回率的原则。

最终检查:重新阅读更新后的 dedupe-issue-local 配套技能,确认任何新聚类都是明确的。保持配套简洁,优先使用规范链接和简短区分说明而非长篇文字。将任何更改提交到名为 oz-agent/update-dedupe 的本地分支,不要推送该分支;Python 入口将运行写入范围守卫,仅在守卫通过时推送。如果更新值得创建 PR,将从推送的分支打开 PR,并在该 PR 上标记 @captainsafia 为评审人。在依赖任何临时 JSON 之前,使用 jq 进行验证。

适用场景:适用于维护者反复将问题关闭为某规范线程重复的仓库,用于沉淀已知重复聚类与识别信号。限制:仅处理 closed-as-duplicate 信号;写入范围严格受限;需 GitHub CLI 认证;默认 7 天回看;不修改核心契约与阈值。