用途
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:读取 Issue 或评审线程,提取症状、复现步骤、错误信息、涉及文件。
- 阶段 2:问题分类,确定问题类型与调查策略。
- 阶段 2.5:Codex 盲审判定,使用全新执行线程,防止锚定,不将 Claude 的分类结果发送给 Codex。
- 阶段 3:执行调查,若判定为 NON_ACTIONABLE 且满足阈值则跳过。
- 阶段 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 导致判定不可用。
- 具体安装命令、收费与价格信息暂未提供。