GitHub 全工作流

一站式 GitHub 操作入口。覆盖从认证到发布的完整生命周期。

快速导航

根据你的需求，加载对应的子技能或直接使用下方命令：

认证（github-auth 内容摘要）

检测当前认证状态

gh auth status 2>/dev/null && echo "gh OK" || echo "gh not authed"
grep -q "GITHUB_TOKEN" ${HERMES_HOME:-~/.hermes}/.env 2>/dev/null && echo "Token in .env" || echo "No token"

Token 配置（国内用户推荐）

1. 去 https://github.com/settings/tokens 创建 Classic PAT
2. 勾选 repo、workflow、read:org
3. 存到 D:\Hermes\.env：GITHUB_TOKEN=ghp_xxx

Git 身份配置

git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global credential.helper store

仓库管理（github-repo-management 内容摘要）

克隆

gh repo clone owner/repo
# 或纯 git:
git clone https://github.com/owner/repo.git

创建仓库

gh repo create my-project --public --clone
# 从已有目录推送:
cd /path/to/project && gh repo create my-project --source . --public --push

Fork

gh repo fork owner/repo --clone
# 添加上游:
git remote add upstream https://github.com/owner/repo.git

Release

gh release create v1.0.0 --title "v1.0.0" --generate-notes

Secrets

gh secret set API_KEY --body "value"
gh secret list

PR 工作流（github-pr-workflow 内容摘要）

标准流程

# 1. 从 main 分支
git checkout main && git pull origin main

# 2. 创建特性分支
git checkout -b feat/my-feature

# 3. 提交（用 Conventional Commits 格式）
git add .
git commit -m "feat: add user authentication"

# 4. 推送
git push -u origin HEAD

# 5. 创建 PR
gh pr create --title "feat: add user auth" --body "Closes #42"

# 6. 监控 CI
gh pr checks --watch

# 7. 合并
gh pr merge --squash --delete-branch

提交规范

feat: 新功能
fix: 修 bug
refactor: 重构
docs: 文档
test: 测试
ci: CI/CD
chore: 杂项

代码审查（github-code-review 内容摘要）

审查本地改动

git diff main...HEAD --stat          # 总览
git diff main...HEAD                  # 完整 diff
git diff main...HEAD | grep -n "TODO\|FIXME\|console.log"  # 常见问题扫描

审查 PR

gh pr view 123                # PR 信息
gh pr diff 123                # PR diff
gh pr checkout 123            # 拉取到本地审查
gh pr review 123 --approve    # 批准
gh pr review 123 --request-changes --body "See comments"  # 要求修改

审查检查清单

• 正确性：功能是否按预期工作？边界情况？
• 安全性：有无硬编码密钥？输入验证？SQL 注入？
• 代码质量：命名清晰？无重复逻辑？函数职责单一？
• 测试：新代码有测试？覆盖 happy path + error case？
• 性能：无 N+1 查询？无阻塞操作？
• 文档：公开 API 有文档？README 更新？

Issue 管理（github-issues 内容摘要）

查看

gh issue list --state open --label "bug"
gh issue view 42

创建

gh issue create --title "Bug: xxx" --body "## Steps..." --label "bug"

管理

gh issue edit 42 --add-label "priority:high"
gh issue edit 42 --add-assignee @me
gh issue comment 42 --body "Working on this"
gh issue close 42

Bug Report 模板

## Bug Description
<问题描述>

## Steps to Reproduce
1. <步骤1>
2. <步骤2>

## Expected Behavior
<期望行为>

## Actual Behavior
<实际行为>

CI/CD（Actions）

gh workflow list                    # 列出工作流
gh run list --limit 10              # 最近运行
gh run view <ID> --log-failed       # 查看失败日志
gh run rerun <ID>                   # 重跑
gh workflow run deploy.yml -f env=staging  # 手动触发

国内网络注意事项

• api.github.com 直连可用（HTTP 200）
• git clone 走 443 端口经常不通 → 用 gh repo clone 或 HTTPS
• raw.githubusercontent.com 小文件可行
• 备选镜像 ghfast.top 对大文件不稳定
• HuggingFace 被墙 → 用 ModelScope 替代

相关技能

• [[01-开发流水线]] — 知识图谱中枢节点
• codebase-inspection — 代码库统计分析（pygount）
• [[Hermes 管家架构]] — Hermes 整体架构中的 GitHub 角色