promote-github

name	promote-github
description	GitHub 开源项目推广工作流。README 审计与优化、内容营销生成（博文/帖文/Thread）、 多渠道发布策略、社区建设检查、增长指标追踪。 触发词：推广、promote、github 推广、宣传、marketing、star、README 优化、 写博文、发帖、开源推广、launch、growth、增长。
version	1.0.0
source	claude-skill-promote
license	MIT
author	Atompilot
keywords	["promote","github","marketing","open-source","README","growth","launch"]

Promote GitHub — 开源项目推广 Skill

系统化推广你的 GitHub 开源项目。

---

触发方式

/promote-github                 # 完整推广诊断（首次使用推荐）
/promote-github readme          # README 质量审计 + 优化
/promote-github blog [渠道]     # 生成推广博文（dev.to / 掘金 / Medium）
/promote-github post [平台]     # 生成社交帖文（Twitter / HN / V2EX / Reddit）
/promote-github launch          # 生成首发 checklist
/promote-github status          # 查看增长指标

ARGUMENTS: $ARGUMENTS

---

Phase 0: 项目感知

每次执行的第一步，自动收集项目信息：

# 1. 仓库元数据
gh repo view --json name,description,stargazerCount,forkCount,createdAt,licenseInfo,repositoryTopics,homepageUrl

# 2. README
cat README.md

# 3. 技术栈
ls package.json go.mod Cargo.toml setup.py pyproject.toml *.xcodeproj 2>/dev/null

# 4. 项目年龄和活跃度
git log --oneline | head -20
git log --since="30 days ago" --oneline | wc -l

项目画像

📊 项目画像

仓库：{owner}/{repo}
描述：{description}
技术栈：{language} + {framework}
Stars：{stargazerCount} | Forks：{forkCount}
创建时间：{createdAt} | 最近 30 天提交：{commitCount}
License：{license}
Topics：{topics}

推广阶段：{阶段}

推广阶段判断

Stars	项目年龄	阶段	策略侧重
0-50	< 1 月	🚀 冷启动	README 打磨 + 首发渠道
0-50	> 1 月	🧊 沉默期	找到产品问题或推广渠道问题
50-500	任意	📈 增长期	内容营销 + 社区建设
500+	任意	🌟 成熟期	生态集成 + 演讲 + 贡献者培养

---

命令：/promote-github（完整诊断）

Step 1: 展示项目画像

Step 2: README 快速体检

按 README 审计清单打分（详见 readme 子命令）。

Step 3: 渠道推荐

根据项目技术栈和生态推荐渠道：

技术栈/生态	核心社区	Awesome List	Subreddit
Claude Code / AI Agent	Anthropic Discord, AI Twitter	awesome-claude-code	r/ClaudeAI
React / Next.js	React Discord, Vercel Discussions	awesome-react	r/reactjs
Python / ML	PyData, MLOps Community	awesome-python, awesome-ml	r/MachineLearning
Go	Gophers Slack	awesome-go	r/golang
Rust	Rust Users Forum	awesome-rust	r/rust
Swift / iOS	Swift Forums	awesome-swift	r/iOSProgramming
DevOps / Infra	CNCF Slack	awesome-selfhosted	r/selfhosted
CLI 工具	Hacker News (Show HN)	awesome-cli-apps	r/commandline
通用开发工具	dev.to, Hacker News	—	r/programming

不在表中的技术栈：

1. 检查依赖文件识别核心框架
2. 搜索 awesome-{framework} 是否存在
3. 搜索框架官方 Discord / Slack / Forum

Step 4: 生成行动计划

📋 推广行动计划（{阶段}）

🔴 本周必做：
  1. [ ] {具体动作 + 预期效果}
  2. [ ] {具体动作 + 预期效果}

🟡 下周推荐：
  3. [ ] {具体动作}
  4. [ ] {具体动作}

🟢 持续进行：
  5. [ ] {具体动作}

💡 执行任何一项，直接告诉我，我帮你生成内容。

---

命令：/promote-github readme

逐项检查 README.md，每项 ✅ / ⚠️ / ❌ 评级。

必备元素（缺失 = ❌）

#	检查项	检查方式	为什么重要
1	首屏价值主张	README 前 5 行内有一句话说明	路人 10 秒决定去留
2	安装/Quick Start	有 install / setup / getting started 章节	30 秒跑通 = 转化
3	LICENSE	LICENSE 文件存在	企业用户硬性要求

强烈推荐（缺失 = ⚠️）

#	检查项	检查方式	为什么重要
4	视觉演示	引用了 .gif / .png / .mp4 / 图片 URL	视觉比文字有效 10x
5	Badges	有 ![ 开头的 badge 图片	建立信任
6	对比表	有 With/Without 或 vs 对比	强化差异价值
7	使用示例	有代码块展示核心用法	让用户"看到"而非"想象"
8	目标用户	说明了"谁应该用这个"	帮读者自我筛选

加分项（缺失 = 灰色）

#	检查项	检查方式
9	Contributing 指南	有 CONTRIBUTING.md 或相关章节
10	Changelog	有 CHANGELOG.md
11	多语言	有中英文双版本
12	GitHub Description	gh repo view --json description 精准
13	Topics/Tags	gh repo view --json repositoryTopics 充分

审计输出

📋 README 审计报告

得分：{X}/13

必备元素：
  1. ✅ 首屏价值主张 — "{描述}"
  2. ❌ 安装/Quick Start — 未找到
  3. ✅ LICENSE — MIT

强烈推荐：
  4. ❌ 视觉演示 — 没有 GIF/截图
  ...

🔧 修复建议（按优先级）：
1. [❌ 安装/Quick Start] 建议添加：
   ```bash
   {从依赖文件推断}

2. [❌ 视觉演示] 建议：
   • 录制终端 GIF：brew install vhs && vhs record
   • 或截图核心界面

要修哪些？（编号 / 全部 / 跳过）

用户确认后直接编辑 README.md。

---

## 命令：`/promote-github blog [渠道]`

### 支持渠道

| 渠道 | 语言 | 风格 | 长度 |
|------|------|------|------|
| `dev.to` | 英文 | 技术教程风 | 800-1500 词 |
| `medium` | 英文 | 叙事 + 技术 | 1000-2000 词 |
| `juejin` | 中文 | 技术实战 | 1500-3000 字 |
| `v2ex` | 中文 | 口语化 | 500-1000 字 |
| `zhihu` | 中文 | 深度分析 | 1500-3000 字 |

未指定渠道时询问用户选择。

### 生成流程

**Step 1: 选角度**

| 角度 | 适用场景 | 标题模板 |
|------|---------|---------|
| 痛点驱动 | 解决明确痛点 | "{痛点} — Here's How I Fixed It" |
| 故事驱动 | 有趣的创作背景 | "Why I Built {项目名}" |
| 教程驱动 | 明确使用场景 | "How to {动作} with {项目名}" |
| 对比驱动 | 有明确竞品 | "{项目名} vs {竞品}" |
| 趋势驱动 | 踩中技术趋势 | "{趋势} Is Changing {领域}" |

**Step 2: 生成大纲** → 用户确认

**Step 3: 生成全文**

**写作规则**：
- 标题痛点导向，不要产品名导向
- 开头用真实场景，不要"在这篇文章中"
- 代码块可直接复制运行
- 不用 "amazing" "revolutionary" 等营销词
- CTA 放末尾，一句话

生成后写入 `docs/promote/blog/{渠道}-{日期}.md`。

---

## 命令：`/promote-github post [平台]`

### 各平台模板

#### Twitter / X Thread

1/N {场景引出问题} 2/N {展示痛苦} 3/N {引出方案} 📎 建议配图 4/N {快速上手命令} 5/N {CTA + GitHub 链接}

#### Hacker News

标题：Show HN: {项目名} – {一句话（≤80 字）} 正文：2-3 段，覆盖问题、方案、差异化

⚠️ 工作日美东 8-10 AM 发 | 不用营销词 | 准备回答技术问题

#### V2EX

标题：口语化（"做了个工具解决 xxx 问题"） 节点：分享创造 / 程序员 / 开源软件 正文：故事化叙述 + 截图 + GitHub 链接

⚠️ 口语化真诚 | 认真回复评论

#### Reddit

Subreddit：{根据技术栈推荐} 正文：先说问题再引项目 | 不要 "I built" 开头 | 先给价值

#### Product Hunt

Tagline + Description + Makers Comment

生成后写入 `docs/promote/posts/{平台}-{日期}.md`。

---

## 命令：`/promote-github launch`

🚀 首发 Checklist

📦 发布前：

• README 审计 ≥ 10/13
• GitHub description 精准
• Topics ≥ 3 个
• LICENSE 存在
• 有 GIF/截图
• Quick Start 30 秒跑通
• 无硬编码密钥 / debug 输出

📣 首发日（选工作日）：

• HN Show HN（美东 8-10 AM）
• Reddit（对应 subreddit）
• Twitter/X Thread
• V2EX + 掘金
• 相关项目 Discussions/Discord

📈 首发后 48h：

• 回复所有评论
• 回复所有 Issues
• PR 到 Awesome Lists
• 记录各渠道数据

---

## 命令：`/promote-github status`

```bash
gh repo view --json stargazerCount,forkCount,watchers,openIssues
gh api repos/{owner}/{repo}/traffic/views
gh api repos/{owner}/{repo}/traffic/clones
gh api repos/{owner}/{repo}/traffic/popular/referrers

输出：

📊 {项目名} 增长报告

⭐ Stars: {count} ({趋势})
🍴 Forks: {count}
📈 14 天流量：Views {count} | Clones {count}
🔗 Top 来源：{referrer list}

💡 建议：{1-2 条具体建议}

---

社区建设检查

• CONTRIBUTING.md 存在
• 有 good first issue 标签
• Issue/PR 模板已配置
• 回复 issue 平均 < 24h
• 被 awesome list 收录

---

避坑指南

陷阱	为什么	替代方案
刷 star	GitHub 检测 + 虚假 star 无价值	靠内容和社区自然增长
营销词	技术社区反感	用事实和数据说话
冷启动硬推	社区反感广告	先贡献价值，再自然提及
只发一次	推广是持续行为	按节奏持续输出
一稿多投	各平台风格不同	按平台定制内容
忽略反馈	不回复 = 无人维护	48h 内回复所有评论

---

内容存储

docs/promote/
├── blog/                    # 博文草稿
│   ├── devto-2026-03-11.md
│   └── juejin-2026-03-11.md
├── posts/                   # 社交帖文
│   ├── twitter-2026-03-11.md
│   └── hn-2026-03-11.md
└── status-log.md            # 增长记录

首次运行时自动创建目录：mkdir -p docs/promote/{blog,posts}

---

自我进化协议

本 skill 在日常使用中自动进化。无需显式触发。

何时提议进化

信号	示例	行为
用户发现新有效渠道	"在 {社区} 发帖效果很好"	提议加入渠道矩阵
渠道规则变化	"HN 不允许 Show HN 带 emoji"	提议更新对应模板
用户纠正内容风格	"V2EX 不要这么正式"	提议调整风格指南
新平台涌现	用户提到 Bluesky / 小红书	提议新增平台模板

确认流程

🔔 我注意到一个可以写入 skill 的改进：

{描述}

建议写入：promote-github/SKILL.md 的「{章节名}」
内容预览：
---
{内容}
---

是否写入？(Y/N)

写入后 version patch +1。

Size Guard

守护线：≤ 15KB

• 12KB → 写入前警告

• 15KB → 必须先压缩再写入

侧重点

新渠道发现、推广效果反馈、内容模板优化、平台规则变更。