关于 gh-issue-fix-flow
将 GitHub issue 从接收推进到实现、测试、提交和推送的 skill。它结合 gh issue 调查、本地代码修改、XcodeBuildMCP 构建与测试及 git 操作,面向 Apple 平台仓库的开发者。
主要功能
- 01通过 gh 获取 issue 详情
- 02使用 rg 定位代码路径
- 03实施精简修复并添加测试
- 04通过 XcodeBuildMCP 构建和测试
- 05提交并推送改动
适用场景
- 01调查已报告的 GitHub issue
- 02实现并验证针对性修复
- 03运行 Apple 平台的定向测试
- 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 上下文
- 使用
gh issue view <id> --repo <owner/repo> --comments获取 issue 的完整上下文。 - 如果仓库不明确,运行
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。 - 测试:优先使用针对性方案(例如
mcp__XcodeBuildMCP__test_sim)。
- 设置一次默认值:
- 如果 macOS 测试因部署目标不匹配而失败,运行对应的 iOS 模拟器测试。
- 报告警告或失败;不要隐瞒。
5) 提交并推送
- 使用
git status --short检查是否有无关更改。 - 仅暂存修复内容(排除无关文件)。
- 使用结束语提交:
Fix … (closes #<issue>)。 - 使用
git push推送。
6) 反馈结果
- 总结更改内容及其位置。
- 提供测试结果(包括失败情况)。
- 说明任何后续事项或受阻事项。
评论
支持 Markdown