SKILL.md
GitHub Star 持续增长实操手册
⚠️ Scope Differentiation:
gingiris-opensource= Launch burst (0→1K in 72h). This skill = Sustained monthly growth (1K→10K→60K+).
Star 地区分布 & 发布时序
适用于 launch 阶段（和
gingiris-opensource配合使用）
- 同一国家/地区 star 占比不超过 20%，是上 GitHub Trending 的隐性门槛。
- 工具：star-history.com（涨幅趋势）· OSS Insight（国家分布，国人开发）
- 发布时序：第一周海外宣发，第二周才做国内（朋友圈 / 中文社群）。
- AFFiNE 真实案例：开源第一周拿 6000 star，几乎全来自海外渠道。
- 陪跑好的项目节奏参考：至少提前 2-3 个月准备；
爆发期一周 4000-6000 star，三周可达 10000 star。
Star 地域分布健康基准
AFFiNE 开源前一周研究 VSCode / Vue / AppFlowy 等知名开源项目 star 分布总结的基准（口述回忆，数字加 ≈）
| 地区 | 健康占比 |
|---|---|
| 美国 | ≈19–21% |
| 中国 | ≈19–21% |
| 欧洲（法德意英合计） | ≈10–15% |
| Top 10 常客 | 印度、俄罗斯、巴西通常在列 |
- 硬规则：开源第一周全员禁发朋友圈，内容英文优先——防止中文圈流量污染全球化分布。AFFiNE 第一周 ≈6,000 star 的分布与知名项目基准吻合（中国 ≈19%）。
- 反例教训：第二周团队发朋友圈后，中国占比飙到 ≈35%，此后再没降下来——分布一旦被污染基本不可逆。
- 反模式：呼朋唤友第一二天刷 500-1,000 star 是舒适圈行为，会污染"全球市场试水温"的真实信号。
README 用户路径闭环（Star CTA Loop）
AFFiNE 开源实战 SOP：任何用户路径跳出去，都要能跳回来点 star。
- 枚举用户所有出口路径：README→官网；README→开发者文档；README→社区（Discord 等）。
- 每个出口页面都反向链接回 GitHub README：官网、文档站、社区页全部回链。
- 每个回链位置加一句 star CTA（"If you like us, please give us a star on GitHub"）。
- 闭环自检：沿每条路径走一遍，确认用户从任意出口都能一步跳回 repo 并看到 star 引导。
- README/官网随阶段更新：策略目标转变（如转向商业化）就即时改版，不要一成不变。
Star 引流漏斗纪律
- 所有渠道统一回溯 GitHub link，而非官网：Reddit / Twitter / Medium / 目录站发布的链接终点都指向 repo，保证所有流量都会看到 README 里的 star 引导。
- README 30 秒内让用户 get 价值，并直接引导点 star。
- 首周每个渠道发不同主题的 post，不是同一篇复制粘贴。
- 起量第一周每天看 GitHub Insights 的流量来源，据此决定接下来几天重点维护哪些渠道；"维护"= 去该渠道和潜在用户对话，不是 paid marketing。
- 私信对标产品的 Twitter follower list：发布日定向私信 Notion / Miro 类竞品的 follower，AFFiNE 实战转化 ≈几百个 star（口述数字）。
- 战略转移信号：star 到 ≈6,000 后不再把精力放在 GitHub 本身，转向 1v1 用户聊天 + 搭建用户社区。
- 永远不要买 star：AFFiNE 从未买星，star 涨太快时多家投资人 DD 写爬虫验证 star 来源，完全干净——买星在尽调时必被识破。
- 看增速不看绝对值：star 增速（而非总量）才是融资和 Trending 信号；GitHub Trending 有账号权限体系，非唯 star 论。
核心目标
| 指标 | 月度目标 | 数据来源 |
|---|---|---|
| 月增 Star | 300+ | Client Project A 8个月辅导数据 |
| 内容产出 | 8-12篇/月 | 博客+视频+社交 |
| KOL 触达 | 60-80/月 | 每天3-4个 |
| 社区活动 | 1次线上/月 | 31-34人参与 |
| Contributor PR | 10+/月 | Good First Issues |
月度执行框架（300 Star/Month Cadence）
1. 内容节奏
| 频率 | 渠道 | 内容类型 | 效果基准 |
|---|---|---|---|
| 每周 2-3 篇 | Dev.to / Medium / 官方博客 | 技术教程、用例解析、对比文章 | SEO 长尾流量 |
| 每周 1 个 | YouTube | 视频教程/Demo | 30 SGD 推流有效 |
| 每天 1-2 条 | Twitter/X | 技术向短内容、GIF、Thread | DM回复率 3-5% |
| 每周 1 篇 | 长文/案例分享 | DM回复率 10-15% |
2. 社区运营
| 渠道 | 频率 | 策略 | 转化效率 |
|---|---|---|---|
| 每周 2-3 帖 | r/selfhosted, r/programming, r/MachineLearning | 帖子→Star 直接转化（AFFiNE 累计 2000+ stars） | |
| Hacker News | 每月 1-2 次 | Content submission via agency ($500/post, ensure HN guidelines compliance — submissions must be genuine and relevant) | 爆发式，单帖可带 200-500 stars |
| Discord/Telegram | 每天 | 日常互动、问题解答 | 社区留存、口碑传播 |
| Dev.to / Hashnode | 每周 1 篇 | 跨平台分发 | SEO + 开发者发现 |
3. 活动驱动增长
| 类型 | 频率 | 目标人数 | 执行要点 |
|---|---|---|---|
| 线上活动（Webinar/AMA） | 每月 1 次 | 31-34 人 | 技术分享 + Live Demo + Q&A |
| 线下活动（Meetup） | 每季度 1 次 | 70 人 | 特定市场深耕（如日本） |
| PR Challenge | 每季度 1 次 | — | Hacktoberfest / Good First Issue Sprint |
| Hackathon 赞助 | 按需 | 200-500 stars/场 | 印度学生黑客松效率最高 |
4. Contributor 体系
阶梯设计：
- Good First Issues — 标注清晰、低门槛、有 mentor 响应
- Regular Contributor — 累计 3+ PR merged → 加入 Contributors 列表
- Core Contributor — 负责特定模块 → Repo write access
- Maintainer — 代码审核权 + 社区管理权
关键动作：
- 每周标注 3-5 个 Good First Issues
- PR 24h 内首次响应
- 月度 Contributor Spotlight（社交媒体 highlight）
5. Ambassador 计划
角色定义：社区传播者，非代码贡献者
激励：
- 专属 badge + README 致谢
- 早期功能体验权
- 年度线下活动邀请
- 推荐奖励（affiliate 模式 10-15%）
招募标准：
- 已在社交媒体自发分享过项目
- 技术社区有一定影响力（1K+ followers）
- 愿意每月产出 2+ 内容
渠道优先级矩阵
| 渠道 | 适用阶段 | 效率指标 | 优先级 |
|---|---|---|---|
| 全周期 | 帖子→Star 直接转化 | ⭐⭐⭐ | |
| Hacker News | 爆发期 | $500/帖, 30 points | ⭐⭐⭐ |
| Twitter/X | 全周期 | DM回复率 3-5% | ⭐⭐⭐ |
| B2B获客 | DM回复率 10-15% | ⭐⭐ | |
| YouTube | 内容沉淀 | 30 SGD 推流有效 | ⭐⭐ |
| Dev.to | SEO长尾 | 文章可跨平台分发 | ⭐⭐ |
预算分配（月度 $2K-5K 档）
| 项目 | 预算 | 预期产出 |
|---|---|---|
| HN Agency | $500-1000 | 1-2 帖, 各 30+ points |
| YouTube 推流 | $100-300 | 视频曝光 + 网站点击 |
| KOL 合作 | $500-2000 | 5-10 个中腰部 KOL |
| 活动费用 | $200-500 | 1次线上 + 物料 |
| 工具订阅 | $100-200 | Phantombuster、分析工具 |
Note: Automated outreach must comply with platform rate limits and anti-spam policies. Always respect opt-out requests.
数据漏斗
曝光（Impression）
→ 访问 GitHub Repo（CTR 2-5%）
→ Star（访问→Star 转化率 10-30%）
→ Clone/Fork（Star 的 5-10%）
→ Contributor（Fork 的 1-5%）
→ 付费用户/Enterprise Lead实战 Benchmark（数据来源）
| 项目 | 成果 | 时间线 | 关键策略 |
|---|---|---|---|
| AFFiNE | 10K stars in 43 days, 60K+ total | 2023-2026 | Reddit(2000+ stars) + HN + KOL + Contributor体系 |
| Client Project A | 0→10K stars | 8 个月 | 月度300 SOP + HN Agency + YouTube |
AFFiNE Star 时间轴（一手口径）
| 节点 | 数据 |
|---|---|
| 开源日 | 2022-08-03 |
| 72 小时 | ≈1,000 star |
| 第一周 | ≈6,000 star（80% 来自海外） |
| 43 天 | 破 10,000 star |
| 2022-08 至 2022-12 | ≈28 次登上 GitHub Trending（开源第 5 天登顶） |
| 24 个月 | 60,000+ star |
- Reddit 实证：r/selfhosted、PKM 等子版块带来几万流量，累计转化至少 2,000 star（≈10 帖火 3-4 帖，其余没火或被 remove）。
- 可信度背书：全程零 paid marketing、从未买星，多家投资人 DD 时写爬虫验证 star 来源，完全干净。
- 预期管理（self-reported）：复制该 SOP 不保证"一周 6,000 star"，但 3 个月做到 1,000–3,000 star 相对容易，已有其他团队按 SOP 复现。
完整 SOP 参考
详见 [references/full-sop.md](references/full-sop.md) — 包含日/周/月完整执行清单、模板、工具链推荐。