SuperAPI AI 工具集

isaaclab-auditing-an-issue

编程与开发

查看项目

更新于 11-10 06:25

技能介绍

用途

该技能用于处理单个 GitHub issue:判断它针对当前代码是否仍然成立,并在决定关闭时起草回复。若需批量审核多个 issue,官方建议使用 isaaclab-triaging-issue-backlog 技能,它会逐条应用本技能并加入批量控制。核心原则是:评论读起来通顺不代表其声明为真;发布前必须对照当前代码核实每一条事实性声明,并思考关闭会丢失什么,而不只是关闭是否说得通。此外,不能仅因 issue 陈旧就关闭——年龄不是证据。

主要能力

  • 通读完整讨论串(gh issue view NUMBER --repo isaac-sim/IsaacLab --comments),而不只是首帖。
  • 识别回复中打算提出的每一条可核查声明,并按下表逐条验证,优先运行代码而非只读代码:
    • “X 已在 #N 修复/落地”:gh pr view N 返回 MERGED,且其 diff 触及所报告的行为;泛泛的“Merges changes from main” PR 不可作为引用。
    • “Isaac Lab 没有 X”:在 source/isaaclab_tasks/isaaclab_tasks/contrib/、source/isaaclab_contrib/ 和 *_experimental 包中搜索;功能会移入 contrib,缺失性声明容易过时。
    • “SYMBOL 已不存在”:grep -rn "SYMBOL" source/,任何命中即反驳。
    • “BACKEND 支持 X”:检查该后端自己的包;后端有差异,某些类在一个后端抛 NotImplementedError 而在另一个不抛。
    • 关于错误或限制的行为性声明:写临时脚本并用 uv run python 运行;只读 raise 位置不够,守卫可能比看起来更窄。
    • 用法类回答:确认它仍是最佳当前建议,而不只是“给过回答”;同时检查 Isaac Sim 侧的相关能力。
    • 任何 URL:curl -s -o /dev/null -w "%{http_code}" -L "URL" 返回 200。
  • 检查“不关闭”清单后再决定;出现以下任一情况应保留 issue,即使所述关闭理由技术上站得住:维护者已向报告者提问且讨论串仍较新;是对开放 PR 的合并前反馈;是某个本身未修复即关闭的 issue 的重复;标题所述诉求未满足(即使串内相关 bug 已修);受阻于已计划但未落地的上游工作(需确认上游 issue 确实存在,“向上游报”若无人报则不算解决)。保留时记录具体下一步与证据,避免下次审核重复劳动。
  • 按指定风格起草评论:首句以 handle 具体而简短地致谢报告者;说明真正解决它的是什么,文件路径用反引号并附已验证的 PR 链接;邀请在当前版本仍复现时重新打开;不归咎于任何人(避免“我们问过两次没回音”这类责怪报告者的说法,也避免“我们这边没问题”这类推给兄弟团队的说法),描述行为所在位置并分流而非推诿;不点名同事作为负面发现的来源(致谢有帮助的回答可以)。若回复由 AI 辅助,末尾加免责声明页脚,且不得声称未发生的人工审核级别。

使用方式

按工作流执行:读完整讨论串 → 识别可核查声明 → 逐条验证(优先运行代码)→ 检查“不关闭”清单 → 按风格起草评论 → 确认每个链接可解析。验证命令包括 gh pr view PR_NUMBER --repo isaac-sim/IsaacLab --json state,mergedAt,title、curl -s -o /dev/null -w "%{http_code}" -L "URL",行为性声明写临时脚本并 uv run python PATH_TO_SCRIPT 运行;若技能有变更,运行 uv run --no-project python tools/skills/cli.py check。

URL 陷阱方面:当前默认分支源码链接用 github.com/isaac-sim/IsaacLab/blob/HEAD/...,或以反引号引用路径不加链接;包布局会变(例如 isaaclab_ovphysx 已并入 isaaclab_ov),需确认所链接 ref 上路径存在。当前开发文档用 isaac-sim.github.io/IsaacLab/main/...,特定发布声明用 release/3.0.0/...;锚点需确认仍存在,因为若干 2.x 锚点在 3.x 重组中被移除。

适用场景

适用于需要判断单个 Isaac Lab issue 是否仍有效、决定关闭或保留,并撰写回复的维护与 triage 场景。批量场景应改用 isaaclab-triaging-issue-backlog。

限制与常见错误

常见错误包括:信任文笔流畅的草稿(流畅与准确、完整都不相关);只回答“是否给过回复”而非“该回答是否仍正确完整”;引用标题匹配但未读 diff 的 PR;关闭理由虽合理但该 issue 是某个现存问题的唯一记录。资料未提供该技能的具体平台依赖、收费或价格信息。维护上需让 URL 陷阱部分与当前包布局保持同步,避免在公开评论中产生死链。