repo-publish-guardlisted
Install: claude install-skill stoneyang0213/repo-publish-guard
# 开源发布守门
## 这个 skill 要解决的真问题
公开一个仓库是**不可逆**的动作。仓库可以转私有,但已经被爬过、被 fork 过、被搜索引擎索引过的内容收不回来。GitHub 上有专门扫新增公开仓库找密钥的机器人,窗口期是分钟级。
而最容易漏的不是"忘了删 .env",是**删了 .env 但历史还在**。`git rm` 只改变最新一次提交的状态,那个 blob 还躺在 `.git/objects` 里,`git log -p` 一翻就出来。stoneyang 就有过一次差点把受访者中文名命名的测评原话推上去的事故(见 memory `feedback_pii_scan_before_commit`)。
所以这个 skill 的骨架是:**先过闸门,再谈别的**。README 写得再漂亮,漏一个 key 就全盘皆输。
## 流程
### Step 0 — 先分清是哪种场景
- **发布前**(本地项目还没公开):走 Step 1-6 全流程
- **存量审计**(仓库已经公开,想回头检查):只走 Step 1 的 `--remote` 模式,然后 Step 2
问清楚这个,因为两种场景的紧迫性完全不同。已公开仓库里扫出 HIGH,那不是"别推了",而是"这个 key 可能已经泄露了,现在就去 revoke"。
### Step 1 — 扫描闸门(不可跳过)
```bash
python <skill>/scripts/scan_secrets.py --path <项目路径>
```
审计已公开仓库:
```bash
python <skill>/scripts/scan_secrets.py --remote stoneyang0213/<repo>
```
脚本扫三层,分别对应三个漏点:
| 层 | 漏点 |
|---|---|
| 工作区 | 眼睛能看见但没注意的文件,含未 track 的 |
| 暂存区 | 已 `git add` 还没 commit 的 |
| **git 全历史** | **曾经提交过、后来删掉的 —— 最容易漏,危害最大** |
退出码即结论:`0` 干净 / `1` 有 HIGH,阻断 / `2` 只有 MEDIUM 或 LOW,需人工判断。
**为什么用脚本而不是自己读文件**:密钥有确定的正则形状,规则扫描比模型逐行看可靠得多,也快得多,而且扫 git 全历史时输出量大到不适合进上下文。你的判断力应该花在 Step 2 的分诊上,不是花在当正则引擎。
### Step 2 — 分诊,只报告不代劳
把结果整理给 stoneyang,**不要自己动手修**。三条理由,每条都足够:
1. **revoke 只有他能做**。真泄露了,最要紧的动作是去平台后台把 key ���废 —— 你做不到,而清理仓库不 revoke 等于没做,那串 key 已经被人看过了。
2. **改写 git 历史是破坏性操作**,会让所有已有 clone 和 fork 失效。这类操作按他的安全红线必须他本人决定。
3. **误报需要人判断**。MEDIUM 里混着测试固件、示例值、哈希常量,只有他知道哪个是真的。
按这个结构报告:
```
HIGH(阻断发布)
<规则>: <掩码> — 出现在 <层> <位置>
→ 处置:1) 立刻去 <note 里的平台> revoke 2) 再谈清理仓库
MEDIUM(需你判断)
<规则>: <掩码> — <位置>
→ 是真 k