github-issue-fix 是做什么的?
Codex 技能,用于修复上游 GitHub 问题与 PR CI 失败。
概述
本技能专为 Codex 平台设计,帮助你自动修复 GitHub 仓库中的 Issue 或 Pull Request 的 CI 问题。通过分析问题描述、错误日志和测试输出,它能生成直接的代码补丁,并可选地提出拉取请求。
使用场景
- 快速修复开源项目中的 Bug 报告(Issue)。
- 解决 Pull Request 中 CI 检查失败的问题。
- 自动化维护 GitHub 仓库,减少手动工作。
工作原理
- 输入:接受一个 GitHub Issue URL 或 PR 链接。
- 分析:提取问题细节、错误日志、堆栈跟踪等上下文。
- 生成修复:使用 AI 模型分析上下文并生成代码更改。
- 验证:可选地运行本地测试或 CI 模拟来确认修复效果。
- 输出:创建修复补丁或直接提交拉取请求。
依赖
git命令行工具- GitHub CLI (
gh) 或有效的 GitHub API 令牌 - Codex 环境(支持
OPENAI_API_KEY或类似环境变量)
配置
技能通过以下环境变量或技能配置文件进行配置:
GITHUB_TOKEN:GitHub 个人访问令牌(用于创建 PR 或读取私有仓库)。FIX_TARGET:要修复的 Issue/PR URL(例如https://github.com/owner/repo/issues/123)。BRANCH_PREFIX:分支前缀(默认fix-)。COMMIT_MESSAGE:自定义提交消息(可选)。
示例
# 设置令牌
export GITHUB_TOKEN="ghp_xxxxxxx"
# 运行技能(在 Codex 中)
codex run OSS-AIE/github-issue-fix --fix-target https://github.com/myorg/myrepo/issues/42
注意事项
- 确保有足够权限读取目标仓库的 Issue 和 PR。
- 生成的修复建议可能需要人工审核后再合并。
- 在运行前,技能会尝试在本地克隆目标仓库的主分支或相关分支。
更多信息
查看 GitHub 仓库 了解最新更新和详细文档。