SuperAPI AI 工具集

harvesting-review

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能针对 PR 评审线程中反复出现的同类意见,将它们抽象成可供后续作者遵循的规则,避免同类问题在下一个 PR 中再次被提出。它是 audit-docs 的对应物:后者从功能改动扫覆盖,它从评审线程出发。

主要能力:解析 $ARGUMENTS(PR 编号、分支名或留空取当前分支)拉取 PR 信息与评审评论;从每条评论抽象出底层规则,仅保留满足“可泛化、可写成祈使句、能防止重复评论”三条的候选;在做出任何判断前,先重建“改动前→改动后”并核实主张;检查内部文档是否已覆盖该规则,并区分“缺失”“已覆盖但无效”“归错位置”“过时矛盾”“不适用”;最后提出对最具体文档位置的最小修改建议,并按需应用。

使用方式:通过 gh 命令获取 PR 评论,例如 gh pr view <n> --json title,body,headRefName,commits 和 gh api repos/opsmill/infrahub/pulls/<n>/comments --paginate。经验规则的去向包括 .agents/rules/*.md、dev/guidelines/、dev/knowledge/、dev/guides/** 以及各级 AGENTS.md;.agents/ 为真相来源,.claude/rules 等为其符号链接。应用修改后运行 uv run invoke docs.lint。

适用场景:适用于需要把 PR 评审中的通用性意见沉淀进团队内部文档、减少评审重复劳动的场景。

限制:该技能强调必须先调查后决策,不得凭评论字面做判断,不得编造未落地的修复;不得因假设已有 linter 或类型检查器而降低规则;不负责解决评审线程,线程解决由人类评审者决定;报告先呈现发现,应用为可选步骤。资料中未提供该技能的收费、价格或独立平台信息。