SuperAPI AI 工具集

manage-issue-analyze

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:对指定 issue 执行根因分析。按顺序四步:加载并校验 issue、收集代码库上下文、运行 CLI 分析、附加分析记录,再把结果写回 .workflow/issues/issues.jsonl。

主要能力:

  • 从 issues.jsonl 按 id 查找行,要求 ISS-ID 符合 ISS-[0-9]{8}-[0-9]{3} 格式,并解析 id、title、description、status、context、related_files。status 非 open 或 registered 时发出 W001 但仍继续。
  • 上下文收集:standard 深度用 grep 在 src/** 中搜索标题与描述关键词(-C 3),有 related_files 则直接读取;deep 深度启动语义探索代理收集受影响位置、调用链、数据流、错误处理与测试覆盖缺口。
  • CLI 分析:调用 maestro delegate --to gemini --mode analysis(可用 --tool gemini|qwen 切换),产出 root_cause、affected_files、impact_scope、fix_direction、confidence 等结构化字段。提示词先写入临时文件再通过 $(cat ...) 引用,避免 shell 注入。
  • 写回:仅修改 analysis 与追加 issue_history,其他字段保持不变,历史追加不覆盖。

用法示例: $manage-issue-analyze "ISS-20260401-001" $manage-issue-analyze "ISS-20260401-001 --depth deep" $manage-issue-analyze "ISS-20260401-001 --tool qwen --depth standard"

适用场景:issue 分析 → 计划 → 执行工作流中的第一步,完成后提示运行 $manage-issue-plan "<ISS-ID>"。

限制与错误处理:E001 未提供 ISS-ID;E002 格式错误;E003 未在 issues.jsonl 找到;E004 CLI 无可解析结果时可换 --tool 重试或报告部分结果。分析须有 file:line 证据,不得推测;若 deep 启动代理,须在第三步前 close_agent。本资料未提供收费、价格与平台支持等信息。