GitHub Operations Skill

为 AI 助手提供的完整 GitHub 操作指南

English | 中文

---

中文

简介

这是一个为 AI 助手设计的 GitHub 操作技能，支持 SSH 和 Token 两种认证模式，涵盖仓库管理、代码协作、PR 工作流等完整功能。

功能特性

功能	SSH 模式	Token 模式
克隆仓库	✅	✅
推送代码	✅	✅
拉取更新	✅	✅
创建仓库	❌	✅
删除仓库	❌	✅
Fork 仓库	❌	✅
创建 PR	❌	✅
API 操作	❌	✅
CI/CD 集成	❌	✅

快速开始

安装（Hermes Agent）

# 方式1：通过 CLI 安装
hermes skills install github-operations

# 方式2：手动安装
git clone https://github.com/ZYFUP/github-operations-skill.git
cp github-operations-skill/SKILL.md ~/.hermes/skills/github/github-operations/

安装（其他 AI 助手）

将 SKILL.md 文件复制到你的 AI 助手的技能目录即可。

使用流程

1. 用户请求 GitHub 操作
2. AI 询问认证模式（SSH / Token）
3. AI 引导用户完成配置
4. AI 执行相应操作
5. AI 验证操作结果

支持的操作

• 仓库管理：创建、克隆、删除
• 代码协作：推送、拉取、分支管理
• PR 工作流：Fork、创建 PR、合并
• API 调用：任何 GitHub REST API 操作

系统要求

• Git 2.0+
• Bash / Zsh
• curl（Token 模式）
• jq（可选，用于 JSON 解析）

提交规范

feat:     新功能
fix:      修复 bug
docs:     文档更新
style:    代码格式
refactor: 重构
test:     测试相关
chore:    构建/工具
perf:     性能优化
ci:       CI/CD 相关

相关链接

• Hermes Agent
• GitHub API 文档
• Git 文档

许可证

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

---

English

Introduction

A complete GitHub operations skill for AI assistants, supporting both SSH and Token authentication modes, covering repository management, code collaboration, and PR workflows.

Features

Feature	SSH Mode	Token Mode
Clone repos	✅	✅
Push code	✅	✅
Pull updates	✅	✅
Create repos	❌	✅
Delete repos	❌	✅
Fork repos	❌	✅
Create PRs	❌	✅
API operations	❌	✅
CI/CD integration	❌	✅

Quick Start

Installation (Hermes Agent)

# Method 1: Install via CLI
hermes skills install github-operations

# Method 2: Manual install
git clone https://github.com/ZYFUP/github-operations-skill.git
cp github-operations-skill/SKILL.md ~/.hermes/skills/github/github-operations/

Installation (Other AI Assistants)

Copy the SKILL.md file to your AI assistant's skills directory.

Usage Flow

1. User requests GitHub operation
2. AI asks for auth mode (SSH / Token)
3. AI guides user through setup
4. AI performs the operation
5. AI verifies the result

Supported Operations

• Repository management: Create, clone, delete
• Code collaboration: Push, pull, branch management
• PR workflow: Fork, create PR, merge
• API calls: Any GitHub REST API operation

Requirements

• Git 2.0+
• Bash / Zsh
• curl (Token mode)
• jq (optional, for JSON parsing)

Commit Convention

feat:     New feature
fix:      Bug fix
docs:     Documentation
style:    Code style
refactor: Refactoring
test:     Tests
chore:    Build/tools
perf:     Performance
ci:       CI/CD

Related Links

• Hermes Agent
• GitHub API Docs
• Git Docs

License

This project is licensed under the MIT License - see the LICENSE file

---

Made with ❤️ by ZYFUP