用途:对指定 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。本资料未提供收费、价格与平台支持等信息。