| 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 渠道的铁律
- 只打 feature-request / 用户提问 issue，绝不打 bug 报告。 "能加 X 吗" 是开放问题，分享别的工具已有
X 是正当同行信息；bug 报告是宿主实现的封闭范围，进去推等于批评。
guard.py 不知道 issue 类型 —— 这一条
靠筛选阶段把关。
- 每仓终身 ≤ 2 条（
config.json per_repo_lifetime_cap）。历史上 chenhg5/cc-connect 13 条、
RichardAtCT/claude-code-telegram 10 条 —— 这种集中度正是 AUP §4「coordinated inauthentic activity」
要抓的轮廓。guard.py 会按 registry 里的历史强制拦截超限的仓。
- 不打上游本体仓（
anthropics/claude-code 等，见 deny_repos）—— 不是同类桥接，曝光最高、有官方
triage、风险最大。历史误打了 14 条，停止。guard.py 直接 deny。
- 每条独立起草 + 必带披露行（"I'm building / 我在做 pikiloom"）。披露既是诚实也是护身符；boilerplate
翻译版仍是 boilerplate，
guard.py 变体检查会拦。
Step 1: 预检
cd /Users/admin/Desktop/project/pikiloom
python3 .pikiloom/skills/_promo/guard.py caps
Step 2: 主路径 — 同领域项目 issue
walk 下列同类项目的 issue tracker（pikiloom 原生支持 Telegram/Feishu/WeChat/Slack/Discord/DingTalk/WeCom，
所有 IM-bridge 仓都是同渠道同类）。bucket 内并行，按时间排序，忽略 >90 天且无活动的。
Bucket A — IM-channel peers（原生，契合度最高）
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
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
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 条候选时才跑）
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
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>"
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 天后再来"）。
