GitHub 操作技能

本技能提供GitHub操作的完整解决方案，包括仓库管理、分支管理、PR和Issue管理、安全最佳实践、开源项目规范和IM通道集成。

核心功能

1. 仓库管理

• - 创建仓库：支持设置仓库名称、描述和隐私设置
• 列出仓库：获取用户所有仓库列表
• 查看仓库详情：获取仓库的详细信息
• 删除仓库：安全删除指定仓库

2. 分支管理

• - 创建分支：从默认分支创建新分支
• 列出分支：获取仓库的所有分支

3. PR管理

• - 创建PR：支持设置标题、内容、源分支和目标分支
• 列出PR：获取仓库的所有PR

4. Issue管理

• - 创建Issue：支持设置标题和内容
• 列出Issue：获取仓库的开放Issue

5. 安全最佳实践

• - Token管理：使用环境变量存储GitHub token
• .gitignore配置：确保敏感文件不被提交
• Git历史清理：移除已提交的敏感信息
• 最小权限原则：使用最小权限的token

6. 开源项目规范

• - README.md：项目说明、安装指南、使用方法
• LICENSE：开源许可证文件
• CONTRIBUTING.md：贡献指南
• 标准目录结构：组织代码和文档

7. IM通道集成

• - 飞书：通过Webhook发送消息
• 企业微信：通过企业微信应用发送消息
• 微信个人号：通过iLink Bot发送消息
• Slack：通过Slack API发送消息

环境配置

1. 安装依赖

bash
pip install PyGithub python-dotenv requests

2. 配置环境变量

创建.env文件：

GitHub API Token

GITHUB_TOKEN=你的GitHub令牌

飞书配置

FEISHUWEBHOOKURL=https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-id

企业微信配置

WECOMCORPID=你的企业ID WECOMAPPSECRET=你的应用密钥 WECOMAGENTID=你的应用ID

微信个人号配置

WEIXINBOTTOKEN=你的iLink Bot Token WEIXINAPIURL=https://api.ilink.qq.com

Slack配置

SLACKAPITOKEN=你的Slack API Token

使用示例

仓库管理

bash

列出所有仓库

python main.py repo list

创建新仓库

python main.py repo create --name my-repo --description 我的新仓库

获取仓库详情

python main.py repo get --name my-repo

删除仓库

python main.py repo delete --name my-repo

分支管理

bash

创建新分支

python main.py branch create --repo my-repo --name feature-branch

列出分支

python main.py branch list --repo my-repo

PR管理

bash

创建PR

python main.py pr create --repo my-repo --title 添加新功能 --body 这是一个新功能 --head feature-branch --base main

列出PR

python main.py pr list --repo my-repo

Issue管理

bash

创建Issue

python main.py issue create --repo my-repo --title Bug报告 --body 有东西坏了

列出Issue

python main.py issue list --repo my-repo

安全措施

1. 1. Token安全：GitHub token存储在环境变量中，不硬编码在代码中
2. 权限控制：使用最小权限的token
3. 操作验证：重要操作需要用户确认
4. 日志记录：记录所有操作，便于审计
5. 错误处理：处理异常情况，避免信息泄露

IM通道集成示例

飞书集成

python
class FeishuIntegration:
def init(self):
self.feishuwebhookurl = os.getenv(FEISHUWEBHOOKURL)

def send_message(self, message):
if self.feishuwebhookurl:
payload = {
msg_type: text,
content: {
text: message
}
}
response = requests.post(self.feishuwebhookurl, json=payload)
return response.json()
return {error: FEISHUWEBHOOKURL not set}

微信集成

python
class WeChatIntegration:
def init(self):
# 企业微信配置
self.wecomcorpid = os.getenv(WECOMCORPID)
self.wecomappsecret = os.getenv(WECOMAPPSECRET)
self.wecomagentid = os.getenv(WECOMAGENTID)

# 微信个人号配置（使用iLink Bot）
self.weixinbottoken = os.getenv(WEIXINBOTTOKEN)
self.weixinapiurl = os.getenv(WEIXINAPIURL, https://api.ilink.qq.com)

开源项目规范

README.md 模板

markdown

项目名称

项目描述

功能特性

• - 功能1
• 功能2
• 功能3

安装说明

1. 1. 克隆仓库
2. 安装依赖
3. 配置环境变量

使用方法

命令示例

bash

命令1

命令2

命令3

贡献指南

详见CONTRIBUTING.md文件。

许可证

本项目采用MIT许可证 - 详见LICENSE文件。

.gitignore 模板

环境变量文件

.env

依赖目录

pycache/ *.py[cod]

编辑器文件

.vscode/ .idea/ *.swp *.swo *~

系统文件

.DS_Store Thumbs.db

最佳实践

1. 1. 代码组织：使用模块化设计，分离核心逻辑和命令行接口
2. 错误处理：使用try-except捕获异常，提供友好的错误信息
3. 文档编写：使用中文编写清晰的文档，便于国内开发者理解
4. 安全意识：时刻注意保护敏感信息，避免硬编码
5. 版本控制：使用Git进行版本控制，提交有意义的commit信息

常见问题

1. GitHub token权限不足

解决方案：在GitHub个人访问令牌设置中，确保选择了适当的权限范围，如repo权限。

2. 网络连接问题

解决方案：检查网络连接，确保能访问GitHub API。

3. 敏感信息泄露

解决方案：使用.gitignore文件排除敏感文件，使用环境变量存储敏感信息。

4. 命令执行错误

解决方案：检查命令参数是否正确，确保仓库名称存在，分支名称有效。

总结

本技能提供了GitHub操作的完整解决方案，涵盖了仓库管理、分支管理、PR和Issue管理、安全最佳实践、开源项目规范和IM通道集成。通过使用本技能，用户可以安全、高效地管理GitHub仓库，创建标准化的开源项目，并通过各种IM通道进行控制。