SuperAPI AI 工具集

issue-analyze

编程与开发

查看项目

更新于 10-16 04:08

技能介绍

用途

issue-analyze 用于对 GitHub Issue 和 PR 评审线程进行深度分析,帮助定位问题根因、分类问题类型并规划调查路径。它适用于需要系统化排查缺陷、评审意见可操作性判断的场景。

主要能力

  • 读取 GitHub Issue:通过 gh issue view 获取标题、正文、标签等信息。
  • 读取评审线程:直接使用提供的 { path, line, reviewer, comment } 数据。
  • 问题分类:根据症状判断问题类型,并映射到相应调查策略。
  • Codex 盲审判定:独立评估可操作性,输出 ACTIONABLE、NON_ACTIONABLE 或 UNCERTAIN,并附带置信度、证据引用和理由。
  • 调查执行:按分类调用对应调查命令。
  • 综合报告:汇总调查结果与判定,输出根因假设、调查策略、优先级等。

使用方式

触发关键词包括:analyze issue、investigate problem、problem analysis、root cause、root cause analysis、triage review、review thread analysis。

输入类型:

  • GitHub Issue:编号、URL 或描述,例如 /issue-analyze 123。
  • 评审线程:file:line 加评审意见,例如 /issue-analyze --triage "src/foo.ts:42 — Use early return"。

模式:

  • Full(默认):执行阶段 1 → 2 → 2.5 → 3 → 4,适用于 Issue 或评审线程的深度分析。
  • Triage(--triage):评审线程输入时仅执行阶段 2 → 2.5;GitHub Issue 输入时执行阶段 1 → 2 → 2.5。

工作流程:

  1. 阶段 1:读取 Issue 或评审线程,提取症状、复现步骤、错误信息、涉及文件。
  2. 阶段 2:问题分类,确定问题类型与调查策略。
  3. 阶段 2.5:Codex 盲审判定,使用全新执行线程,防止锚定,不将 Claude 的分类结果发送给 Codex。
  4. 阶段 3:执行调查,若判定为 NON_ACTIONABLE 且满足阈值则跳过。
  5. 阶段 4:生成综合报告。

问题分类决策树:

  • “以前能用,现在不行” → /git-investigate(查找引入点)。
  • “不知道这个功能如何工作” → /code-explore(快速理解)。
  • 有错误信息或堆栈:清晰错误 → /code-explore(追踪路径);模糊或间歇 → /code-investigate(双视角确认)。
  • “多种可能原因” → /codex-brainstorm(穷举分析)。
  • 复合或不确定 → 先 /code-explore,再根据结果选择。

调查工具对比:

  • /code-explore:快速代码探索,速度快,单视角。
  • /git-investigate:追踪变更历史,速度中等,单视角。
  • /code-investigate:双确认,速度慢,双视角。
  • /codex-brainstorm:穷举可能性,最慢,对抗式。

Codex 盲审要求:

  • 使用全新线程,不复用已有线程。
  • 沙箱与审批策略由适配器固定。
  • 不将 Claude 阶段 2 分类发送给 Codex。
  • 提示构造遵循 verdict-prompt.md 模式,始终包含标准研究块(git status、git diff、grep、cat)。
  • 输出字段:codex_verdict、confidence、evidence_refs、reasoning。

策略映射阈值:

  • NON_ACTIONABLE:置信度 >= 0.80(正常)/ >= 0.85(加强),证据引用 >= 2(正常)/ >= 3(加强),跳过阶段 3 调查(DISMISS_VERIFIED)。
  • ACTIONABLE:置信度 >= 0.70,进入阶段 3(FIX_REQUIRED)。
  • UNCERTAIN 或低置信度:进入阶段 3(NEED_HUMAN)。

--triage 模式在阶段 2.5 后停止,仅输出分类与判定。

优雅降级:仅在 codex_fail(适配器退出码 1)时记录警告并按模式继续。完整模式进入阶段 3,判定记录为不可用;--triage 模式停在阶段 2.5,输出 verdict: UNAVAILABLE (codex_fail)。退出码 2 为配置或用法错误,需暴露并停止;未知完成状态不是失败,应等待。

输出

完整报告(默认):

  • Classification:问题类型
  • Verdict:ACTIONABLE / NON_ACTIONABLE / UNCERTAIN / UNAVAILABLE (codex_fail),含置信度
  • Root cause hypothesis:根因假设
  • Investigation strategy:工具与计划
  • Priority:P0 / P1 / P2

Triage 报告(--triage 模式):

  • Category:分类
  • Verdict:ACTIONABLE / NON_ACTIONABLE / UNCERTAIN / UNAVAILABLE (codex_fail)
  • Confidence:置信度
  • Reasoning:简要理由
  • Evidence:file:line 引用

适用场景

  • 回归问题:API 更新后返回 500,通过 /git-investigate 查找引入提交。
  • 间歇性错误:随机超时,通过 /code-investigate 进行 Claude 与 Codex 双视角分析。
  • 不熟悉的功能:行为异常,通过 /code-explore 追踪执行路径。
  • 评审线程分类:如建议使用提前返回,Codex 发现现有嵌套模式符合项目惯例,判定为 NON_ACTIONABLE。

限制

  • 不适用于已知根因直接修复(使用 /bug-fix)。
  • 不适用于纯功能开发(使用 /feature-dev)。
  • 不适用于仅需代码评审(使用 /codex-review)。
  • 依赖 Codex 调用,可能因适配器退出码 1 导致判定不可用。
  • 具体安装命令、收费与价格信息暂未提供。