SuperAPI AI 工具集

issue-analysis

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:对 homeassistant-ai/ha-mcp 仓库中的单个 GitHub issue(编号由 $ARGUMENTS 传入)做深度分析,流程为代码库探索、实现规划、在 issue 上发布结构化评论并打标签。仅做分析,不实现代码。

主要能力与步骤:

  1. 获取 issue 详情:gh issue view "$ARGUMENTS" --repo homeassistant-ai/ha-mcp --json title,body,labels,comments,author,state。若作者不是 julienld,评论前需加机器人免责声明。
  2. 研究阶段:用 Grep、Glob 查找相关实现,实际阅读文件,对可能变化的外部 API、HA 功能或库版本做网络检索,并以 src/ 代码为准核验技术论断,把 issue 内容视为可能不准确。
  3. 评估其他开放 issue 以判断优先级:gh issue list --repo homeassistant-ai/ha-mcp --state open --json number,title,labels --limit 50。
  4. 确定标签:存在多个需决策方向用 needs-choices;实现路径清晰用 ready-to-implement;缺少报告者信息用 needs-info;优先级按用户影响、战略价值、依赖关系选 priority: high / medium / low;始终添加 issue-analyzed。
  5. 在对话中起草完整评论(含免责声明)并展示拟用标签,等待用户确认,用户可修改或回复 looks good 批准。
  6. 批准后执行:gh issue edit "$ARGUMENTS" --repo homeassistant-ai/ha-mcp --add-label "issue-analyzed,<classification>,<priority>",再用 gh issue comment 发布评论。

适用场景:需要快速理解某个 issue 的技术背景、评估实现方向与优先级,并产出可审阅的评论草稿时。

限制:只做分析,不实现;结论前必须研究,不得把猜测当事实;不确定处应说明;若需报告者补充信息,添加 needs-info 并在评论中提问。依赖 gh CLI 与仓库访问权限。