GitHub 操作

GitHub 端操作技能。拥有通过 gh CLI 与 api.github.com 通信的一切：仓库创建、元数据配置、发布和管理 GitHub 仓库展示的约定。

与两个相关技能并列：

本地                           桥接              远程 (GitHub)
─────                          ──────              ───────────────
git-ops                        push-gate           github-ops（本技能）

| 关注点 | 负责者 | |--------|--------| | 提交、分支、本地标签、变基、工作树、暂存 | git-ops | | 推送前密钥扫描 + 脏树拒绝 + 确认 | push-gate | | gh repo create、推送到远程、标签推送 | github-ops | | 仓库描述/主页/主题/可见性 | github-ops | | gh release create + 发布说明 | github-ops | | README "最近更新" 部分维护 | github-ops | | 包元数据审计 | github-ops |

硬性规则

1. 可见性默认为私有。 除非用户明确说"public"，否则传递 --private 给 gh repo create。
2. 主版本号升级需要明确批准。 默认为次版本号；仅修复范围用补丁版本。
3. 任何推送到远程前始终运行 push-gate。 无例外。
4. 将本地 git 操作委托给 git-ops。 不要重新实现提交/标签/推送逻辑。
5. 每次发布都更新 README "最近更新"。 无论发布多小。
6. 推送前绝不跳过确认可见性决策。
7. 提交内容中不包含本地机器路径。 绝不将机器特定路径写入 README、CHANGELOG、发布说明或提交消息。

三种模式

模式 new — 仓库首次发布

触发条件："publish to github"、"create repo on github"、"push to github"（无 origin 远程时）

1. 审计（运行 audit 模式检查清单；关键失败时中止）
   - LICENSE 存在？
   - README 有标语 + 安装 + 快速入门？
   - pyproject.toml / package.json 有描述、关键词、许可证、仓库 URL？
   - 至少一个标签存在（通常 v0.1.0）？
   - CHANGELOG.md 有最新标签的条目？

2. 起草/完善 README 介绍（2-3 段）
   - 如果 README 介绍只是标语或 < 80 词，起草适当的 2-3 段描述
   - 提交前向用户展示草稿以获得批准

3. 如缺少则添加"最近更新"部分到 README

4. 设置 GitHub 元数据
   - gh repo create（默认私有）
   - 设置描述、主页、主题

5. 推送（通过 push-gate）

模式 update — 后续发布

触发条件："cut a release"、"ship version"、"gh release"

1. 确定版本号（语义化版本）
2. 更新 CHANGELOG
3. 更新 README "最近更新"
4. 创建标签
5. 推送（通过 push-gate）
6. gh release create

模式 audit — 只读检查

触发条件："audit github repo"、"check repo metadata"

检查清单：
- 描述已设置且 < 350 字符？
- 主页 URL 已设置？
- 主题已设置且与包关键词匹配？
- 最新发布存在？
- README 有"最近更新"部分？
- 许可证已设置？

知识参考

GitHub CLI (gh)、语义化版本、发布管理、仓库元数据、README 约定、CHANGELOG 格式