
使用方式
关于
使用 GitHub Actions 设计高效 CI/CD 工作流,包括矩阵构建、缓存、可复用工作流和密钥管理。
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 |
硬性规则
- 可见性默认为私有。 除非用户明确说"public",否则传递
--private给gh repo create。 - 主版本号升级需要明确批准。 默认为次版本号;仅修复范围用补丁版本。
- 任何推送到远程前始终运行
push-gate。 无例外。 - 将本地 git 操作委托给
git-ops。 不要重新实现提交/标签/推送逻辑。 - 每次发布都更新 README "最近更新"。 无论发布多小。
- 推送前绝不跳过确认可见性决策。
- 提交内容中不包含本地机器路径。 绝不将机器特定路径写入 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 格式
兼容工具
Claude CodeCursorGitHub Copilot
标签
运维部署


