promote

name	promote
description	GitHub 截流。在同领域项目（local coding agent ↔ IM / mobile / remote console）的 feature-request issue 下，自动发现→起草→自我批判→护栏→（按 posture）发布 pikiloom 回复，并记录+度量。话术统一来自 _promo/pitch.md；可由 _promo/orchestrate.md 无人值守驱动。
version	6.0.0

GitHub Promotion Workflow

This skill targets the open issues of same-space projects (local coding agent ↔ IM / mobile / remote console) — where users have already self-identified as needing this category of tool. We share pikiloom as another option; we never position against the host project.

This file holds GitHub-specific mechanics only (which repos, which issues, how to post). All product copy, differentiators, honesty bounds, tone, language, skeleton, and anti-patterns come from ../_promo/pitch.md — do not duplicate or edit copy here. Dedup / guardrails / posting-posture / measurement come from the shared core:

关注点	位置
产品话术 SSOT	_promo/pitch.md（§9 表 github 列 = 本渠道机制差异）
去重（写时强制）	_promo/registry.py（channel = github）
护栏（每仓上限/日配额/变体/熔断/deny_repos）	_promo/guard.py
飞书推送 / 度量	_promo/push_feishu.py / _promo/measure.py
无人值守编排 + posture	_promo/orchestrate.md
旋钮	_promo/config.json → channels.github

运行根目录：cd /Users/admin/Desktop/project/pikiloom。脚本前缀：.pikiloom/skills/_promo/。

GitHub 渠道的铁律

1. 只打 feature-request / 用户提问 issue，绝不打 bug 报告。 "能加 X 吗" 是开放问题，分享别的工具已有 X 是正当同行信息；bug 报告是宿主实现的封闭范围，进去推等于批评。guard.py 不知道 issue 类型 —— 这一条 靠筛选阶段把关。
2. 每仓终身 ≤ 2 条（config.json per_repo_lifetime_cap）。历史上 chenhg5/cc-connect 13 条、 RichardAtCT/claude-code-telegram 10 条 —— 这种集中度正是 AUP §4「coordinated inauthentic activity」 要抓的轮廓。guard.py 会按 registry 里的历史强制拦截超限的仓。
3. 不打上游本体仓（anthropics/claude-code 等，见 deny_repos）—— 不是同类桥接，曝光最高、有官方 triage、风险最大。历史误打了 14 条，停止。guard.py 直接 deny。
4. 每条独立起草 + 必带披露行（"I'm building / 我在做 pikiloom"）。披露既是诚实也是护身符；boilerplate 翻译版仍是 boilerplate，guard.py 变体检查会拦。

---

Step 1: 预检

cd /Users/admin/Desktop/project/pikiloom
python3 .pikiloom/skills/_promo/guard.py caps      # github 今日剩余配额；为 0 则今天不跑

Step 2: 主路径 — 同领域项目 issue

walk 下列同类项目的 issue tracker（pikiloom 原生支持 Telegram/Feishu/WeChat/Slack/Discord/DingTalk/WeCom， 所有 IM-bridge 仓都是同渠道同类）。bucket 内并行，按时间排序，忽略 >90 天且无活动的。

Bucket A — IM-channel peers（原生，契合度最高）

# Telegram
for r in chenhg5/cc-connect RichardAtCT/claude-code-telegram a5c-ai/claude-code-telegram-bot \
         seedprod/claude-code-telegram cutevisor/return-by-death JohannOosthuizen/Gemini-CLI-Telegram-Bot \
         ada720725-star/claude-code-telegram gohyperdev/hdcd-telegram; do
  gh issue list --repo "$r" --state open --limit 40; done
# Feishu
for r in laborany/laborany MidnightV1/Claude-Code-Feishu whobot-ai/claude-code-feishu-channel \
         m1heng/clawdbot-feishu CherryLover/claude-code-feishu AwadYoo/claude-code-feishu-channel \
         czm15053/claude-code-feishu-channel AkaiZheng/ClaudeCode-Feishu-Channel; do
  gh issue list --repo "$r" --state open --limit 30; done
# WeChat
for r in Johnixr/claude-code-wechat-channel Wechat-ggGitHub/wechat-claude-code m1heng/claude-plugin-weixin; do
  gh issue list --repo "$r" --state open --limit 30; done

Bucket B — 更多 IM-channel peers（Discord / Slack / DingTalk / WeCom，均原生）

for r in zebbern/claude-code-discord timoconnellaus/claude-code-discord-bot ebibibi/claude-code-discord-bridge \
         BrunoJurkovic/claude-code-discord-status jubalm/claude-code-discord \
         mpociot/claude-code-slack-bot jeremylongshore/claude-code-slack-channel 41fred/claude-code-slack \
         AnandChowdhary/claude-code-slack-bot sfyyy/claude-code-dingtalk-mcp; do
  gh issue list --repo "$r" --state open --limit 30; done

Bucket C — Mobile / remote / dashboard

for r in 9cat/claude-code-app ahmed3elshaer/everything-claude-code-mobile aiya000/claude-code-mobile-ssh \
         qingpingwang/remote-claude-code BMeyn/claude_code_mobile; do
  gh issue list --repo "$r" --state open --limit 30; done

定期刷新仓列表（这个领域更新很快）：

for kw in "claude code telegram" "claude code feishu" "claude code wechat" "claude code discord" \
          "claude code slack" "claude code dingtalk" "claude code wecom" "claude code 企业微信" \
          "claude code mobile" "claude code swarm" "codex telegram" "codex feishu" "gemini cli telegram"; do
  gh search repos "$kw" --limit 15 --json fullName,stargazersCount,description,pushedAt \
    --jq 'sort_by(-.stargazersCount) | .[] | "\(.stargazersCount)★ \(.fullName) — \(.description // "")"'
done

10★ 且 90 天内有 push 而不在上面的，按类别补进 A/B/C。

Step 3: 次路径 — 关键词搜索（主路径不足 5 条候选时才跑）

# billing 段 = 最高转化（付 API credits、想用 Max 订阅跑自动化的人）；GitHub issue 搜索是 term-AND，
# 长 phrase 返回 ~0，用下面这些校准过能出 open issue 的词：
for q in "claude code billing" "claude code credits" "claude max api" "use claude subscription" \
         "claude code subscription" "claude code mobile" "claude code telegram" "claude code 飞书" \
         "claude code 微信" "agent web dashboard" "run multiple coding agents"; do
  gh search issues "$q" --state open --limit 30 --json url,title,repository \
    | jq -r '[.[] | select(.repository.name | test("trending|news|weekly|github-daily|awesome|digest|bulletin|pikiloom|pikiclaw"; "i") | not)
        | select(.repository.nameWithOwner | test("xiaotonng/") | not)]
        | .[] | "\(.url) | \(.title) | \(.repository.nameWithOwner)"'; done

billing 段命中时，回复用 pitch §2 角度 0 开场（守住 §3 诚实边界）。 丢弃 issue-mirror / digest bot（republish 别人 issue，OP 不在那）：小仓上的 4–5 位 issue 号、 或标题像 [upstream PR N] … / Weekly Tech Report / AI CLI 日报。起草前先 gh issue view 确认。

Step 4: 去重 + 筛选

对每个候选 URL 先去重，再 gh issue view <url> 读全文再判断：

python3 .pikiloom/skills/_promo/registry.py seen github "<issue_url>" && echo SKIP   # 已记录则跳过

全部满足才选： ① 是 feature-request / 用户提问（不是宿主实现相关的 bug）② pikiloom 今天就有这个能力 （不要硬拗，读者会查）③ 线程还活着（近期活动，未 closed/wontfix/locked）④ 作者是用户而非 maintainer 在做路线规划。 任一命中即跳过： bug 报告 / maintainer 已承诺修或有在飞 PR / 社区公告 / pikiloom 并无该能力 / 争议政治帖。

pikiloom 真正能解的痛点见 pitch.md §2（角度 0 billing 是头牌差异点；其余按 OP 痛点挑 1–2 个）。选 3–6 条最强候选。

Step 5: 起草（子 agent，话术来自 pitch.md）

委托子 agent 起草，唯一内容契约 = ../_promo/pitch.md：peer-position+orienter(§1) → out-of-box 主张(§8 step2，回答"装好是不是开箱即有") → 一句实现证据(§4) → npx pikiloom@latest → https://github.com/xiaotonng/pikiloom。语言跟随 issue 正文(§6)，≤5 句，挑 1–2 个对得上的差异点(§2)。

每条起草后记录：

python3 .pikiloom/skills/_promo/registry.py add --channel github --url "<issue_url>" \
  --status drafted --repo "<owner/repo>" --type <feature-request|question> --lang <en|zh|ja> \
  --title "<issue 标题>" --draft-file /tmp/promo_draft_<id>.txt

Step 6: 自我批判（替代人工 review gate）

对每条草稿按 pitch.md §10 自检（营销腔 / 对比宿主 / >2 差异点 / 超 5 句 / 没 ground issue 痛点 / 缺披露 / 越诚实边界 / boilerplate）。FAIL → 子 agent 修一次；再 FAIL → update --status skipped 丢弃。不做第三次。

Step 7: 护栏 + 按 posture 发布

python3 .pikiloom/skills/_promo/guard.py check --channel github --url "<issue_url>" \
  --draft-file /tmp/promo_draft_<id>.txt        # exit 3 = deny（每仓上限/deny_repos/日配额/变体）；deny 则跳过
POSTURE=$(python3 -c "import json;print(json.load(open('.pikiloom/skills/_promo/config.json'))['posture'])")

• shadow：不发，推预览卡片。
• batch：update --status approved + 推 veto 卡片，veto 窗口后由后续 run 发（见 orchestrate.md Phase 4）。
• auto：直接发：

gh issue comment "<issue_url>" --body-file /tmp/promo_draft_<id>.txt
python3 .pikiloom/skills/_promo/registry.py mark-posted --channel github \
  --url "<issue_url>" --post-url "<我们评论的 url>"      # 失败则 update --status failed

GitHub gh 发帖是三渠道里最可靠、最可逆的，建议 auto 从 github 先开。

Step 8: 报告 + 度量 + 回访

python3 .pikiloom/skills/_promo/registry.py stats
python3 .pikiloom/skills/_promo/push_feishu.py --report-file /tmp/promo_report.md --title "🚀 GitHub Promote"
python3 .pikiloom/skills/_promo/measure.py report

回访：≥24h 的评论若被 hide/lock，registry.py update --channel github --url <u> --status hidden —— 会触发 guard.py 熔断，暂停该渠道。报告含：搜索/候选/已发/跳过/失败计数 + 下轮建议（如"Feishu 簇有 4 条新 open issue，7 天后再来"）。