mcpField
G
gh-issue-fix-flow

gh-issue-fix-flow

github.com/dimillian开发4.0k194 次安装30 周前更新
代码仓库

关于 gh-issue-fix-flow

将 GitHub issue 从接收推进到实现、测试、提交和推送的 skill。它结合 gh issue 调查、本地代码修改、XcodeBuildMCP 构建与测试及 git 操作,面向 Apple 平台仓库的开发者。

主要功能

  1. 01通过 gh 获取 issue 详情
  2. 02使用 rg 定位代码路径
  3. 03实施精简修复并添加测试
  4. 04通过 XcodeBuildMCP 构建和测试
  5. 05提交并推送改动

适用场景

  1. 01调查已报告的 GitHub issue
  2. 02实现并验证针对性修复
  3. 03运行 Apple 平台的定向测试
  4. 04准备修复并推送

MCP 相关

使用 XcodeBuildMCP 设置构建默认值,并运行 macOS 或模拟器构建与测试。issue 到推送的流程还使用 gh 和 git。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/dimillian/skills --skill gh-issue-fix-flow

安装后在 Claude Code 中输入/gh-issue-fix-flow确认已加载。

详细介绍

Gh Issue Fix Flow

概述

使用 gh、本地编辑、XcodeBuildMCP 和 git,从接收 GitHub issue 到修复、验证并推送,完成整个处理流程。

工作流

1) 接收并了解 issue 上下文
  1. 使用 gh issue view <id> --repo <owner/repo> --comments 获取 issue 的完整上下文。
  2. 如果仓库不明确,运行 gh repo view --json nameWithOwner 进行确认。
  3. 记录复现步骤、预期行为和维护者备注。
2) 定位代码路径
  1. 使用 rg -n 查找可能涉及的文件和入口点。
  2. 使用 sed -n 或带上下文的 rg -n 阅读相关代码路径。
  3. 遵循仓库特定约定(AGENTS/CLAUDE 指令)。
3) 实施修复
  1. 编辑最少数量的文件。
  2. 使更改符合现有架构和风格。
  3. 行为发生变化且实际可行时,添加测试。
4) 构建和测试
  1. 使用 XcodeBuildMCP 执行所需的构建和测试:
    • 设置一次默认值:mcp__XcodeBuildMCP__session-set-defaults。
    • 构建:mcp__XcodeBuildMCP__build_macos 或 mcp__XcodeBuildMCP__build_sim。
    • 测试:优先使用针对性方案(例如 mcp__XcodeBuildMCP__test_sim)。
  2. 如果 macOS 测试因部署目标不匹配而失败,运行对应的 iOS 模拟器测试。
  3. 报告警告或失败;不要隐瞒。
5) 提交并推送
  1. 使用 git status --short 检查是否有无关更改。
  2. 仅暂存修复内容(排除无关文件)。
  3. 使用结束语提交:Fix … (closes #<issue>)。
  4. 使用 git push 推送。
6) 反馈结果
  1. 总结更改内容及其位置。
  2. 提供测试结果(包括失败情况)。
  3. 说明任何后续事项或受阻事项。

评论

支持 Markdown