wjs-promoting-skills

# wjs-promoting-skills

每天早上 4:00 自动跑一遍：挑一个 `wjs-*` skill → 生成今日推广角度 → 发到 X → 起草社区帖。**X 真发，社区只起草到 outbox/ 让人工 review。**

## Core Principle

**Claude 是大脑，bash 是骨架。** 这个 skill 的所有判断（今天推哪个、怎么写、什么角度）都交给 `claude -p` 跑 headless 调用 —— bash 只负责定时、传 context、写日志、防重发。这样新增 skill / 新增渠道 / 改风格不需要改代码，只改 prompt 模板。

**真发只有一个渠道：X。** Reddit / HN / Discord 都没有可靠的「按用户身份自动发帖」API（要么需要 OAuth + 反垃圾审查，要么完全没接口）。所以这个 skill 把社区帖只**起草到 `outbox/<date>/`**，等人工 copy-paste。

**Idempotent + 节流。** 每天最多 1 条 X 帖。同一 skill 不在 7 天内重复推。如果 SKILL.md 自上次推广后没改、且过去 7 天没变化，跳过当天。这避免变成一个吵闹的机器人。

## When This Skill Fires

- 用户说「帮我推广这些 skills」/「设置每天自动发推广」/「研究一下别人怎么推广 skill 的」
- 用户用 `/wjs-promoting-skills` 显式调用
- 用户问「今天准备推哪个 skill」/「outbox 里有什么」

如果用户只想发**一次**（不要 cron），直接用 `/publish-skill <name>` —— 那是单条手动版。本 skill 的价值是**每天自动**。

## File Layout

```
~/.claude/skills/wjs-promoting-skills/
├── SKILL.md                                # 本文件
├── setup.sh                                # 一次性：装 launchd plist，启动 4 AM 定时
├── uninstall.sh                            # 一次性：卸 launchd plist
├── daily.sh                                # ★ 4 AM 入口：跑一遍完整流程
├── list-skills.sh                          # 列出当前所有 wjs-* skill
├── pick-next-skill.sh                      # 按轮换规则挑今日 skill
├── research-marketplaces.sh                # 研究 openclaw / clawhub / SkillsMP 的爆款怎么写文案（每月跑一次）
├── make-plan.sh                            # 给一个 skill 生成 marketing plan（30 天 angle rotation）
├── com.jianshuo.wjs-promoting-skills.plist.template
├── prompts/
│   ├── research-marketplaces.md            # 研究 prompt
│   ├── make-plan.md                        # marketing plan prompt
│   ├── daily-post.md                       # 今日 X 帖 prompt
│   └── community-drafts.md                 # Reddit / HN / Discord 草稿 prompt
├── state/                                  # 状态目录（.gitignored，不会被 publish hook 推到 GitHub）
│   ├── .gitignore
│   ├── README.md
│   ├── research.md                         # 最近一次 marketplace 研究的产物
│   ├── plans/<skill>.md                    # 每个 skill 的 30 天 angle rotation 计划
│   └── history.jsonl                       # 每次跑完追加一行：date / skill / tweet_id / status
└── outbox/                                 # 社区帖草稿（人工 review 后 copy-paste 出去）
    └── YYYY-MM-DD/
        ├── x-posted.txt                    # 实际发出去的 X 帖文本（archive）
        ├── reddit-r-ClaudeAI.md
        ├── hn-show.md
        ├── discord-anthropic.md
        └── wechat-followup.md              # （可选）下次写公众号文章时的角度参考
```

## Setup (one-time)

```bash
~/.claude/skills/wjs-promoting-skills/setup.sh
```

会做三件事：
1. 检查前置依赖：`claude` CLI、`xurl`（且 `xurl whoami` 能返回用户）、`jq`
2. 跑一次 `research-marketplaces.sh` 生成初始 `state/research.md`（**只此一次会真上网调研**，下次每月自动刷新一次）
3. 把 `com.jianshuo.wjs-promoting-skills.plist.template` 渲染成真正的 plist 放到 `~/Library/LaunchAgents/`，然后 `launchctl bootstrap`

跑完之后每天 04:00 自动触发，不需要任何手动操作。

要停止：`~/.claude/skills/wjs-promoting-skills/uninstall.sh`

## Daily Flow (4 AM — what `daily.sh` does)

```
04:00 →
  Step 1: list-skills.sh        → 当前所有 wjs-* skill 的清单 + 各自上次推广时间
  Step 2: pick-next-skill.sh    → 按规则挑出今天的 skill（见 §Rotation Rules）
  Step 3: 检查跳过条件             → 7 天内推过 / SKILL.md 没动 / outbox 已有今日 → 直接 exit 0
  Step 4: make-plan.sh <skill>  → 如果该 skill 没有 plan 或 plan 老于 30 天，重新生成
  Step 5: claude -p 跑 daily-post.md
            └── 输入: SKILL.md + plan + research.md + history.jsonl 最近 30 天
            └── 输出: 一条 ≤ 280 char 的 X 文本（包含 repo URL）
  Step 6: xurl -X POST -d '{"text": "..."}' /2/tweets   ← 真发
  Step 7: claude -p 跑 community-drafts.md
            └── 输出: outbox/<date>/reddit-r-ClaudeAI.md / hn-show.md / discord-anthropic.md
  Step 8: 追加一行到 history.jsonl，并把发出去的 X 帖归档到 outbox/<date>/x-posted.txt
```

每周日跑完 daily 之后额外：
- `research-marketplaces.sh` 刷新一遍 `state/research.md`（看看 marketplaces 上当周爆款的写法变化）

每月 1 号跑完 daily 之后额外：
- 对所有 plan 老于 30 天的 skill 重跑 `make-plan.sh`（rotate angles）

## Rotation Rules (pick-next-skill.sh)

按优先级从高到低排：

1. **从没推过的 skill** —— 优先推，让新 skill 早点曝光
2. **最近 7 天内没推过的 skill** —— 在这些里挑 SKILL.md 最近**有修改**的（说明用户刚迭代过）
3. **其它** —— 在所有 skill 里挑「距离上次推广最久」的那个

如果所有 skill 都在 7 天内推过 → 当天跳过（避免变成噪音）。
如果所有 skill 都从没推过 → 按字母序挑第一个。

## X Post Format (daily-post.md output)

Constraints:
- ≤ 280 字符（X 算 URL 为 23 字符，预留 25）
- 第一行：skill name + 一句话价值
- 中间：2–3 个具体能力 / 此次更新的差异点
- 倒数第二行单独一行放 repo URL（X 自动 render preview card）
- 最多 1 个 hashtag（`#ClaudeCode` 或 `#ClaudeSkills`）
- **不许**：营销腔、火箭 emoji、`AI-powered`、`game-changer`、夸张词
- **必须**：用户的语气（参考 README.md 里 wjs-* skill 的文风：实用、具体、不吹牛）

Angle rotation（同一个 skill 多次推时不重复）：
- 角度 A：**它解决的具体问题**（"75 分钟 4K 多机位 60GB 重编码同步会让磁盘翻倍" 这种细节）
- 角度 B：**反直觉的设计决策**（"sidecar over re-encode" 这种）
- 角度 C：**串联工作流**（和其他 skill 一起跑出什么效果）
- 角度 D：**最近一次更新的差异**（如果 SKILL.md 自上次推广有改动，diff 出来重点讲新东西）

`make-plan.sh` 会把这四种角度排成 30 天的 rotation，每条都预写一个 hook 句。

## Community Drafts (community-drafts.md output)

不真发。落到 `outbox/<date>/`，人工 review 后 copy-paste：

- **`reddit-r-ClaudeAI.md`**：长文格式，开头一句钩子，正文讲场景 + 代码片段 + 链接，结尾问一个开放性问题（Reddit 喜欢 discussion 不喜欢 ad）。**Selfpost only**，绝不放纯链接帖
- **`hn-show.md`**：Show HN 格式，标题 `Show HN: <skill> – <one line value>`，正文 < 600 字，注明开源协议 + repo URL，**不要在 HN 卖东西**
- **`discord-anthropic.md`**：短贴，2–3 句话 + 链接，适合 #show-and-tell 频道
- **`wechat-followup.md`**（可选）：如果该 skill 适合写一篇公众号文章详细讲，给个 200 字大纲 + 几个 angle，下次用户写文章时直接用

如果用户当天太忙没 review，不会重发 —— 帖子就停留在 outbox 里，第二天会再生成新的（针对另一个 skill）。

## Manual Override

测试 / 调试用 —— 任何一步都能单独跑：

```bash
# 看看明天会推谁
~/.claude/skills/wjs-promoting-skills/pick-next-skill.sh

# 给某个 skill 强制生成 plan
~/.claude/skills/wjs-promoting-skills/make-plan.sh wjs-transcribing-audio

# 把今天的整个 flow 跑一遍但不发 X（dry-run）
DRY_RUN=1 ~/.claude/skills/wjs-promoting-skills/daily.sh

# 强制推某个 skill（绕过 rotation）
SKILL=wjs-segmenting-video ~/.claude/skills/wjs-promoting-skills/daily.sh

# 刷新 marketplace 研究
~/.claude/skills/wjs-promoting-skills/research-marketplaces.sh

# 看最近 7 天推过什么
tail -7 ~/.claude/skills/wjs-promoting-skills/state/history.jsonl | jq .
```

## Prerequisites

- `claude` CLI 在 `$PATH`，且 `claude -p "hello"` 能跑通（headless 模式）
- `xurl` 已装，`xurl whoami