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. 安装依赖
pip install PyGithub python-dotenv requests
2. 配置环境变量
创建.env文件：
# GitHub API Token
GITHUB_TOKEN=你的GitHub令牌
# 飞书配置
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-id
# 企业微信配置
WECOM_CORP_ID=你的企业ID
WECOM_APP_SECRET=你的应用密钥
WECOM_AGENT_ID=你的应用ID
# 微信个人号配置
WEIXIN_BOT_TOKEN=你的iLink Bot Token
WEIXIN_API_URL=https://api.ilink.qq.com
# Slack配置
SLACK_API_TOKEN=你的Slack API Token
使用示例
仓库管理
# 列出所有仓库
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
分支管理
# 创建新分支
python main.py branch create --repo my-repo --name feature-branch
# 列出分支
python main.py branch list --repo my-repo
PR管理
# 创建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管理
# 创建Issue
python main.py issue create --repo my-repo --title "Bug报告" --body "有东西坏了"
# 列出Issue
python main.py issue list --repo my-repo
安全措施
- Token安全：GitHub token存储在环境变量中，不硬编码在代码中
- 权限控制：使用最小权限的token
- 操作验证：重要操作需要用户确认
- 日志记录：记录所有操作，便于审计
- 错误处理：处理异常情况，避免信息泄露
IM通道集成示例
飞书集成
class FeishuIntegration:
def __init__(self):
self.feishu_webhook_url = os.getenv('FEISHU_WEBHOOK_URL')
def send_message(self, message):
if self.feishu_webhook_url:
payload = {
"msg_type": "text",
"content": {
"text": message
}
}
response = requests.post(self.feishu_webhook_url, json=payload)
return response.json()
return {"error": "FEISHU_WEBHOOK_URL not set"}
微信集成
class WeChatIntegration:
def __init__(self):
# 企业微信配置
self.wecom_corp_id = os.getenv('WECOM_CORP_ID')
self.wecom_app_secret = os.getenv('WECOM_APP_SECRET')
self.wecom_agent_id = os.getenv('WECOM_AGENT_ID')
# 微信个人号配置（使用iLink Bot）
self.weixin_bot_token = os.getenv('WEIXIN_BOT_TOKEN')
self.weixin_api_url = os.getenv('WEIXIN_API_URL', 'https://api.ilink.qq.com')
开源项目规范
README.md 模板
# 项目名称
项目描述
## 功能特性
- 功能1
- 功能2
- 功能3
## 安装说明
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. **代码组织**：使用模块化设计，分离核心逻辑和命令行接口
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通道进行控制。