🔀 github-flow-skill

One Command, Full GitHub Flow

一条 /github 命令，把"裸 push"升级成 分支 → Issue → PR → 自审 → 合并 的正规协作流程

很多人（尤其是个人项目）习惯直接 git commit && git push 到 main，结果 GitHub 个人主页的贡献雷达图变成一条横线：Commits 占了 97%，Pull requests 个位数，Issues 和 Code review 直接是 0。

这个 Skill 让 Claude Code 在你输入 /github 时，自动把当前改动走完整流程：

① 建 Issue                → 计入 Issues
② 切规范分支
③ commit + push
④ 开 PR（Closes #Issue）   → 计入 Pull requests
⑤ 贴自审 comment           → 计入 Code review
⑥ 停下来等你确认
⑦ squash 合并 + 删分支 + 自动关 Issue → 计入 Commits

一次跑完，雷达图四个角同时 +1。坚持几周，那条横线就会鼓成一个饱满的多边形。

想先看看实际效果？直接读 examples/示例流程.md，那是本仓库自己真实跑过的一次循环。

✨ 特点

• 全程命令行：基于 gh CLI，不用打开 GitHub 网页。
• 显式触发：只有你输入 /github 才运行，平时的 git commit / git push 完全不受影响，绝不自动套用。
• 合并前刹车：分支、Issue、PR、自审全自动完成，但合并这一步会停下来，给你 PR 链接和 diff 摘要，等你说"合并"才执行——不可逆的操作绝不替你做主。
• 不止是刷图：Issue 逼你想清楚再动手、分支隔离改动、PR 留下可回溯的讨论页面——刷雷达图只是副产品。

📦 安装

方法一：简易安装（推荐）

把下面这段话直接粘贴到 Claude Code 里，让它带着你把安装和检查一次走完：

帮我安装这个 skill：https://github.com/LeoLee0812/github-flow-skill
把仓库里的 github/ 文件夹装到 ~/.claude/skills/，
然后帮我检查 gh CLI 是否已安装并完成登录（gh auth status），
没装的话带我装好并登录。

Claude 会自己克隆仓库、复制文件、检查依赖，全程不用手动操作。

方法二：手动安装

前提：已安装 gh CLI 并完成 gh auth login。

1. 把 github/ 这个文件夹复制到 Claude Code 的 skills 目录：

   git clone https://github.com/LeoLee0812/github-flow-skill.git
   cp -r github-flow-skill/github ~/.claude/skills/

2. 重启 Claude Code（或新开一个会话），输入 / 应该能看到 github。

🚀 使用

在任意一个 git 仓库目录里，写完代码、准备提交时，别急着 push，直接：

/github

Claude 会看你当前的改动 → 建 Issue → 切分支 → commit + push → 开 PR → 贴自审 comment → 停下来等你确认 → 你说"合并"后 squash 合并、删分支、自动关 Issue。

🛠️ 自定义

技能的全部行为都写在 github/SKILL.md 里，纯自然语言，直接改即可。常见改法：

• 想真审一遍代码：把"贴自审 comment"那步换成先跑 /code-review，把审查结论作为 PR comment 贴上去。
• 想全自动一条龙：删掉"停下来等确认"那一步，让它直接合并（自己权衡风险）。
• 改分支 / commit 命名规范：在对应步骤里改约定即可。

📁 仓库结构

.
├── README.md
├── LICENSE
├── github/
│   └── SKILL.md            # ← 这就是 skill 本体，复制到 ~/.claude/skills/
└── examples/
    └── 示例流程.md          # 一次真实运行的完整过程，看看效果

📄 许可

MIT License，欢迎自由使用和二次修改。

---

如果这个 skill 帮到你了，欢迎分享给同样想把贡献雷达图养饱满的朋友 📈