GitHub 自动化操作
功能说明
此技能专门用于自动化 GitHub 平台的各种操作，包括：
- 仓库管理和文件操作
- Pull Request 创建和审查
- Issue 管理和追踪
- 分支管理和合并
- CI/CD 工作流自动化
- 代码搜索和分析
使用场景
- "创建一个新的 GitHub 仓库"
- "提交代码并创建 Pull Request"
- "批量处理 GitHub Issues"
- "自动化代码审查流程"
- "搜索代码库中的特定代码"
- "管理 GitHub Actions 工作流"
⚠️ 重要提示：使用 GitHub MCP 推送代码
当需要推送到 GitHub 时，优先使用 mcporter call github.push_files 而不是 git push！
为什么使用 GitHub MCP？
- ✅ 不需要 Personal Access Token - 使用已认证的 GitHub Copilot token
- ✅ 避免认证问题 - SSH key 未配置或 HTTPS token 过期时仍可工作
- ✅ 批量提交 - 一次提交多个文件
- ✅ 更可靠 - 直接通过 GitHub API，不受本地 git 配置影响
推送代码示例
方法1：使用 mcporter（推荐）
bash
1# 单个文件
2mcporter call github.push_files \
3 owner=aAAaqwq \
4 repo=my-repo \
5 branch=master \
6 message="feat: add new feature" \
7 files='[{"path":"README.md","content":"file content"}]'
8
9# 多个文件（使用 Python）
10python3 << 'EOF'
11import json
12import subprocess
13
14payload = {
15 "owner": "aAAaqwq",
16 "repo": "my-repo",
17 "branch": "master",
18 "message": "feat: update multiple files",
19 "files": [
20 {"path": "README.md", "content": "..."},
21 {"path": "src/main.py", "content": "..."}
22 ]
23}
24
25result = subprocess.run([
26 'mcporter', 'call', 'github.push_files',
27 f'owner={payload["owner"]}',
28 f'repo={payload["repo"]}',
29 f'branch={payload["branch"]}',
30 f'message={payload["message"]}',
31 f'files={json.dumps(payload["files"])}'
32], capture_output=True, text=True)
33
34print(result.stdout)
35EOF
方法2：传统 git push（需要配置认证）
bash
1# 仅在 MCP 不可用时使用
2git push origin master
MCP 工具列表
查看所有可用工具：
bash
1mcporter list github --schema
常用工具：
github.push_files - 推送多个文件到仓库github.create_or_update_file - 创建或更新单个文件github.get_file_contents - 获取文件内容github.list_commits - 列出提交历史
核心功能模块
1. 仓库管理
- 创建仓库：创建新的公开或私有仓库
- Fork 仓库：Fork 其他仓库到自己账户
- 搜索仓库：按关键词搜索仓库
- 文件操作：读取、创建、更新文件
- 批量提交：一次提交多个文件
2. Pull Request 管理
- 创建 PR：从分支创建 Pull Request
- 审查 PR：添加评论和审查意见
- 合并 PR：合并 Pull Request
- 查看变更：获取 PR 的文件变更
- 状态检查：查看 CI/CD 状态
3. Issue 管理
- 创建 Issue：创建新的问题或任务
- 更新 Issue：修改状态、标签、负责人
- 搜索 Issue：按条件筛选 Issue
- 添加评论：在 Issue 中添加讨论
- 批量操作：批量处理多个 Issue
4. 分支管理
- 创建分支：从指定分支创建新分支
- 查看提交：列出分支的提交历史
- 分支保护：配置分支保护规则
- 合并策略：选择合并方式（merge、squash、rebase）
5. 代码搜索
- 搜索代码：在仓库中搜索代码片段
- 搜索 Issue：搜索问题和 PR
- 搜索用户：查找 GitHub 用户
- 高级查询：使用 GitHub 搜索语法
工作流程
标准开发流程
- 创建分支：从 main 创建功能分支
- 开发代码：编写和测试代码
- 提交变更：提交文件到分支
- 创建 PR：创建 Pull Request
- 代码审查：团队审查代码
- 合并代码：合并到主分支
自动化发布流程
- 监听事件：监听 push 或 tag 事件
- 运行测试：执行自动化测试
- 构建项目：编译和打包
- 创建 Release：发布新版本
- 部署应用：自动部署到生产环境
Issue 管理流程
- 创建 Issue：报告问题或需求
- 分配任务：指定负责人
- 添加标签：分类和优先级
- 跟踪进度：更新状态
- 关闭 Issue：完成后关闭
最佳实践
提交规范
- 使用清晰的提交信息
- 遵循 Conventional Commits 规范
- 一次提交解决一个问题
- 包含必要的测试和文档
PR 规范
- 提供详细的 PR 描述
- 关联相关的 Issue
- 确保 CI 检查通过
- 及时响应审查意见
- 保持 PR 大小适中
分支策略
- 使用 Git Flow 或 GitHub Flow
- 保护主分支
- 定期同步上游分支
- 及时删除已合并的分支
安全实践
- 不提交敏感信息
- 使用 GitHub Secrets 管理密钥
- 启用双因素认证
- 定期审查权限设置
常用代码示例
1. 创建仓库并提交文件
javascript
1// 创建仓库
2const repo = await createRepository({
3 name: "my-project",
4 description: "项目描述",
5 private: false,
6 autoInit: true
7});
8
9// 批量提交文件
10await pushFiles({
11 owner: "username",
12 repo: "my-project",
13 branch: "main",
14 files: [
15 {
16 path: "README.md",
17 content: "# My Project\n\n项目说明"
18 },
19 {
20 path: "src/index.js",
21 content: "console.log('Hello World');"
22 }
23 ],
24 message: "Initial commit"
25});
2. 创建分支和 Pull Request
javascript
1// 创建新分支
2await createBranch({
3 owner: "username",
4 repo: "my-project",
5 branch: "feature/new-feature",
6 from_branch: "main"
7});
8
9// 提交代码到新分支
10await createOrUpdateFile({
11 owner: "username",
12 repo: "my-project",
13 path: "src/feature.js",
14 content: "// 新功能代码",
15 message: "Add new feature",
16 branch: "feature/new-feature"
17});
18
19// 创建 Pull Request
20await createPullRequest({
21 owner: "username",
22 repo: "my-project",
23 title: "添加新功能",
24 head: "feature/new-feature",
25 base: "main",
26 body: "## 变更说明\n- 添加了新功能\n- 更新了文档"
27});
3. Issue 管理
javascript
1// 创建 Issue
2const issue = await createIssue({
3 owner: "username",
4 repo: "my-project",
5 title: "修复登录问题",
6 body: "## 问题描述\n用户无法登录\n\n## 复现步骤\n1. 打开登录页面\n2. 输入凭证\n3. 点击登录",
7 labels: ["bug", "high-priority"],
8 assignees: ["developer1"]
9});
10
11// 添加评论
12await addIssueComment({
13 owner: "username",
14 repo: "my-project",
15 issue_number: issue.number,
16 body: "正在调查此问题"
17});
18
19// 更新 Issue
20await updateIssue({
21 owner: "username",
22 repo: "my-project",
23 issue_number: issue.number,
24 state: "closed",
25 labels: ["bug", "fixed"]
26});
4. 代码审查
javascript
1// 获取 PR 详情
2const pr = await getPullRequest({
3 owner: "username",
4 repo: "my-project",
5 pull_number: 123
6});
7
8// 获取 PR 文件变更
9const files = await getPullRequestFiles({
10 owner: "username",
11 repo: "my-project",
12 pull_number: 123
13});
14
15// 创建审查
16await createPullRequestReview({
17 owner: "username",
18 repo: "my-project",
19 pull_number: 123,
20 body: "代码看起来不错，有几点建议",
21 event: "COMMENT",
22 comments: [
23 {
24 path: "src/index.js",
25 line: 10,
26 body: "建议添加错误处理"
27 }
28 ]
29});
30
31// 合并 PR
32await mergePullRequest({
33 owner: "username",
34 repo: "my-project",
35 pull_number: 123,
36 merge_method: "squash",
37 commit_title: "feat: 添加新功能"
38});
5. 搜索和查询
javascript
1// 搜索代码
2const codeResults = await searchCode({
3 q: "function login repo:username/my-project"
4});
5
6// 搜索 Issue
7const issueResults = await searchIssues({
8 q: "is:open label:bug repo:username/my-project",
9 sort: "created",
10 order: "desc"
11});
12
13// 搜索仓库
14const repoResults = await searchRepositories({
15 query: "react stars:>1000 language:javascript"
16});
GitHub Actions 集成
自动化测试
yaml
1name: CI
2on: [push, pull_request]
3jobs:
4 test:
5 runs-on: ubuntu-latest
6 steps:
7 - uses: actions/checkout@v2
8 - name: Run tests
9 run: npm test
自动化部署
yaml
1name: Deploy
2on:
3 push:
4 branches: [main]
5jobs:
6 deploy:
7 runs-on: ubuntu-latest
8 steps:
9 - uses: actions/checkout@v2
10 - name: Deploy
11 run: ./deploy.sh
集成场景
1. 自动化代码审查
- 监听 PR 创建事件
- 运行代码质量检查
- 自动添加审查评论
- 标记需要改进的地方
2. Issue 自动分类
- 监听 Issue 创建
- 分析 Issue 内容
- 自动添加标签
- 分配给合适的人员
3. 发布管理
- 监听版本标签
- 生成变更日志
- 创建 GitHub Release
- 通知团队成员
4. 依赖更新
- 定期检查依赖更新
- 创建更新 PR
- 运行测试验证
- 自动合并安全更新
注意事项
- 遵守 GitHub API 速率限制
- 使用 Personal Access Token 认证
- 正确处理 API 错误和重试
- 保护敏感信息和密钥
- 遵循开源项目贡献指南
