name: github-ops
description: GitHub 仓库操作工具集,支持 Issue 评论回复、PR 创建、Issue/PR 详情查询、代码推送和 PR 创建联动。使用 Python requests 库调用 GitHub API,配合 gh CLI 工具完成分支操作。Use when 用户提到回复 GitHub Issue、创建 PR、推送并创建 PR、查看 issue 状态、GitHub 操作。
GitHub Operations
GitHub 仓库操作工具集,通过 GitHub API + Python 脚本实现自动化操作。
快速开始
场景 1:本地 Git 操作
# 查看工作区状态
py -3 <skill>/scripts/github_ops.py status
# 查看文件差异
py -3 <skill>/scripts/github_ops.py diff
# 查看暂存区差异
py -3 <skill>/scripts/github_ops.py diff-staged
# 提交文件
py -3 <skill>/scripts/github_ops.py commit . "feat: description"
# 撤销文件修改
py -3 <skill>/scripts/github_ops.py discard path/to/file
# 查看分支差异
py -3 <skill>/scripts/github_ops.py branch-log dev master
# 推送分支
py -3 <skill>/scripts/github_ops.py push dev
场景 2:创建 Issue
# 方法1:使用文件路径
echo "【优化建议】标题" > title.txt
echo "Issue 内容..." > body.txt
py -3 <skill>/scripts/github_ops.py create-issue owner repo title.txt body.txt
# 方法2:直接传入文本
py -3 <skill>/scripts/github_ops.py create-issue owner repo "标题" "内容"
场景 3:回复 Issue
# 1. 查看 issue 上下文
py -3 <skill>/scripts/github_ops.py get-issue owner repo 63
# 2. 查看已有评论
py -3 <skill>/scripts/github_ops.py get-comments owner repo 63
# 3. 回复 issue(创建临时 body 文件)
echo "感谢你的提议!" > body.txt
py -3 <skill>/scripts/github_ops.py reply-issue owner repo 63 body.txt
场景 4:创建 PR
# 1. 查看分支差异
py -3 <skill>/scripts/github_ops.py branch-log dev master
# 2. 创建 PR
py -3 <skill>/scripts/github_ops.py create-pr owner repo title.txt body.txt dev master
场景 5:推送并创建 PR
# 1. 提交并推送
py -3 <skill>/scripts/github_ops.py commit . "feat: description" "file1.txt file2.txt"
py -3 <skill>/scripts/github_ops.py push dev
# 2. 创建 PR
py -3 <skill>/scripts/github_ops.py create-pr owner repo title.txt body.txt dev master
工作流程
本地 Git 操作流程
Phase 1 查看状态
1.1 git status(查看改动)
1.2 git diff(查看具体变更)
│
▼
[Checkpoint Scope] ← 确认改动范围
│
▼
Phase 2 决策
2.1 提交(commit)
2.2 撤销(discard)
2.3 继续其他操作
│
▼
Phase 3 执行并推送
3.1 git push origin <branch>
3.2 创建 PR(如需)
GitHub Issue 操作流程
[Checkpoint Before] ← 操作前确认
│
▼
Phase 1 准备
1.1 确定操作类型(issue/pr/其他)
1.2 收集必要信息(owner/repo/number/branch)
1.3 准备 body 内容(如需)
│
▼
[Checkpoint Confirm] ← 确认操作意图
│
▼
Phase 2 执行
2.1 GitHub API 操作(Python 脚本)
2.2 Git 分支操作(如需 gh CLI)
│
▼
Phase 3 验证
3.1 检查 API 响应状态
3.2 确认 URL 返回正确
3.3 清理临时文件
自检清单
Git 操作自检
GitHub 操作自检
约束与规范
| 规范 |
说明 |
| Windows 环境 |
使用 py -3 执行 Python 脚本,避免 curl 兼容性问题 |
| Token 配置 |
通过环境变量 GITHUB_TOKEN 设置,不存储在代码中 |
| API 版本 |
v3 (application/vnd.github.v3+json) |
相关资源
| 文件 |
用途 |
| [references/API-REFERENCE.md] |
GitHub API 详细文档 |
| [references/WORKFLOW-GUIDE.md] |
场景化工作流指南 |
| [scripts/github_ops.py] |
Python 操作脚本 |