SuperAPI AI 工具集

gh-issue-fix-flow

编程与开发

查看项目

更新于 10-15 20:31

技能介绍

用途:该技能定义了一个从接单到修复、验证并推送的 GitHub issue 处理流程,结合 gh、本地编辑、XcodeBuildMCP 与 git 使用。

主要流程与能力:

  1. 问题接单:用 gh issue view <id> --repo <owner/repo> --comments 获取完整问题上下文;仓库不明确时用 gh repo view --json nameWithOwner 确认;记录复现步骤、预期行为和维护者备注。
  2. 定位代码:用 rg -n 查找相关文件和入口,配合 sed -n 或 rg -n 上下文阅读代码,并遵循仓库约定的 AGENTS/CLAUDE 说明。
  3. 实施修复:只改最少文件,保持与现有架构和风格一致;行为变化且测试可行时补充测试。
  4. 构建与测试:用 XcodeBuildMCP 完成构建测试。可先用 mcp__XcodeBuildMCP__session-set-defaults 设置默认值,再选用 mcp__XcodeBuildMCP__build_macos 或 mcp__XcodeBuildMCP__build_sim 构建,测试优先用针对性的 scheme(如 mcp__XcodeBuildMCP__test_sim)。若 macOS 测试因部署目标不匹配失败,可改跑等价的 iOS 模拟器测试;需如实报告警告或失败,不得隐瞒。
  5. 提交推送:用 git status --short 检查无关改动,只暂存修复相关文件,提交信息使用类似 Fix … (closes #<issue>) 的闭合格式,再用 git push 推送。
  6. 回报:总结改了什么及位置,提供测试结果(含失败),说明后续事项或受阻项。

适用场景:需要按 issue 编号执行完整修复闭环的 GitHub 仓库,尤其是 iOS/macOS 项目。

限制:资料未提供安装方式、兼容平台、定价和具体环境要求;实际可用性依赖 gh、rg、XcodeBuildMCP、git 等工具已在环境中配置。