github-auto-releaselisted
Install: claude install-skill kuangketongxue/kuang-skills
# GitHub Auto Release v2
一条命令把本地项目开源成「全副武装」的 GitHub 仓库。v2 合并了完整的仓库门面流程(2026-08-24,源自 gaokao-learn 实战)。
## 什么时候用
用户想把项目/skill/工具开源到 GitHub,要求包含:中英 README、About、release、package、贡献者等完整门面。
## 核心能力(一条命令全做完)
1. **隐私扫描**:上传前检测 token / API key(含 `sk-`)/ 密码 / 私钥 / 微信凭证;发现可疑先列出来要确认
2. **创建仓库**:GitHub API(已存在则继续更新门面)
3. **门面设置**:About 描述 + homepage + topics(PATCH /repos/{repo} + PUT /topics)
4. **推代码**:git push;**git 被墙时加 `--api-push` 走 Contents API 逐文件上传**
5. **双语徽章墙 README**:README.md(EN)+ README_zh.md(中文),模板在 `references/`——release/stars/forks/issues/license/changelog/website 徽章 + 语言切换链接 + 贡献者图 + Star History
6. **脚手架**:CHANGELOG.md(Keep a Changelog)、package.json、MIT LICENSE(缺哪个补哪个,已有的不覆盖)
7. **Release**:自动打 tag v1.0.0 + release notes(`--no-release` 跳过)
8. **小红书宣发**(可选):`--publish-xhs` 经 opencli 发长文草稿
## 快速命令
```bash
python scripts/github_release.py \
--repo "owner/repo-name" \
--path ./project \
--title "Project Title" \
--desc "一句话描述" \
--homepage "https://site.example.dev" \
--topics "python,cli,automation"
```
常用变体:`--api-push`(被墙时)、`--readme-langs en,zh,ja`(加日文)、`--no-release`、`--private`。
Token 解析顺序:`--token` > 环境变量 `GITHUB_TOKEN` > `gh auth token`(本机 gh 已登录时无需传 token)。
## Agent 执行要点(踩过的坑)
- **中国网络**:`git push` 走 github.com:443 常连不上;api.github.com 稳定。push 失败报 `Failed to connect` → 重跑加 `--api-push`
- **多文件改动**:对已有仓库批量改文件用 Git Data API 一个 commit(blob→tree→commit→ref 四步),不要逐文件 PUT 触发 N 次 CI
- **Contents API PUT 二次提交必须带最新 sha**:每次 PUT 后 sha 变,重新 GET 取
- **Win