OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add gingiris-1031/gingiris-skills --skill gingiris-twitter-agent-ops
Twitter/X Agent Operations SOP v2 — Rebuilt from real dual-account operations.
npx skills add gingiris-1031/gingiris-skills --skill gingiris-twitter-agent-ops
版本说明：v2 草稿。v1 给了你整套方法论框架，v2 的重点是： 「已经在跑了，怎么确保不出事、出了事怎么发现、发现了怎么处理」。
在讲 SOP 之前，先讲三个真实踩过的坑。这三件事决定了 v2 的核心设计。
事故 1：cron 超时失败 2 周没人发现
cron job 连续超时失败，没有任何监控机制，整整 2 周没有推文发出。等发现时，粉丝增长已经明显停滞，算法分发也已经冷却。 → v2 修复：强制日报机制，发推后必填，缺了就是异常信号。
事故 2：v0.dev 流量数据相差 17 倍，被用户公开指出
推文中引用了单一数据源（DataForSEO）的「非品牌有机搜索」数字，没有交叉验证，被 @gefei55（哥飞）等用户公开指出数据不准，差了整整 17 倍。 → v2 修复：红线自检中加入「数字来源可查」强制检查项，无来源数字不发。
事故 3：某一话题提及频率过高，被用户指出「天天蹭流量」
某段时期内容过度集中在同一品牌/话题上，用户公开反馈感觉是在持续蹭热度，而不是真正分享。 → v2 修复：任何借势话题每月提及上限 1-2 次，在发推前检查本月该话题已出现次数。
Agent 开始运营前，逐步引导用户提供信息，一次只问一个问题。不要一次抛出大表格——用户看到 6 个问题就会不想填。
收集完后给出一段状态判断，再开始工作。
Q1（先问这个）
你的 Twitter/X 账号是什么？现在有多少粉丝？
→ 记录账号名和粉丝基线，作为后续增长对比
Q2
这个账号主要发什么语言？怎么发推的？
语言（可多选）： A) 中文 B) 英文 C) 中英都有
发布方式： A) 手动发 B) Buffer 排期 C) API 直发（cron 自动） D) 不确定 → 先检查发布机制再继续，cron 挂掉 2 周没人知道是真实事故
→ API 直发：中文账号用 OAuth1 四字段凭证；英文账号用 Buffer channel；两套不能混用
Q3
有素材库吗？
A) 有，大概还有 ___ 条没用（存在：本地文件 / Notion / 飞书 / 其他） B) 有，但不确定有多少 C) 没有
→ A 且条数 ≤ 3：本次先补素材，再排期 → C：第一任务建素材库，今天不开始写推文
Q4
最近发推有记录吗？
A) 有 MASTER-STATUS.md 或类似运营日志 B) 有，我可以粘贴最近几条推文 C) 没有任何记录
→ A 或 B：检查是否有断更，避免重复内容 → C：先建 MASTER-STATUS.md，这是整个系统的单一真相来源
Q5
你现在最想让读者记住你的哪 1-2 件事？受众是什么人？
（自由填写，没有选项——这个要你自己说）
→ 确定内容方向，避免选题漂移
Q6（最后问）
现在最重要的目标是什么？
A) 涨粉 B) 引流到某个链接（是哪个链接？___） C) 建立信任感 / 个人品牌 D) 以上都有，但最重要的是 ___
→ CTA 链接写进每条推文的 reply 策略，不放正文（正文带链接算法惩罚展示量 30-90%）
| 情况 | 判断 | 处理方式 |
|---|---|---|
| cron 状态不确定 | 🚨 紧急 | 先检查 cron，确认正常再开始内容工作 |
| 素材库 ≤ 3 条 | ⚠️ 预警 | 本次运营优先补充素材库，不排期 |
| 素材库为空 | 🚨 阻塞 | 必须先建素材库才能排期 |
| 上周发布记录缺失 | ⚠️ 提醒 | 让用户打开 MASTER-STATUS.md 核查 |
| MASTER-STATUS.md 不存在 | 🚨 首次运营 | 本次任务先建立 MASTER-STATUS.md |
这是整个系统中最重要的文件。 任何对话开始前，任何推文发出前后，都必须读写这个文件。
AI 的上下文会被压缩、重置、遗忘。压缩后的记忆摘要不可信——它不会告诉你「今天发没发推」，它只会给你一个看起来合理但可能错误的答案。
只有 MASTER-STATUS.md 是事实。
这个教训在运营中被纠正了不止 5 次，每一次出问题都是因为没有在对话开始时读这个文件。
强制规则：推文发出后 5 分钟内完成日报，不得拖延。
日报的作用：
发推前，逐项检查。任何一项未通过 → 不发，修改后重检。
每周一上午，在发推之前，先生成上周的周报。
素材库是推文内容的原料仓库。所有推文必须来自素材库中已有的素材，agent 不得无中生有。
素材来源：
标记规则：
预警规则：
数据核实规则：
这是一个不允许搞混的硬规则。
来自事故经验：cron 超时失败可以连续 2 周没人发现。
这一节是 v1 的精华提炼，在 v2 中保留。数据来自向阳乔木的 X 运营研究。
| 省什么 | 具体来说 | 内容示例 |
|---|---|---|
| 省搜索 | 读者不用在信息海里找入口 | 「这 10 个工具的入口在这里」 |
| 省理解 | 读者不用自己猜复杂概念 | 「用一张图解释 PLG 是什么」 |
| 省试错 | 读者不用把坑全踩一遍 | 「我已经踩了这些坑，你不用踩了」 |
| 省表达 | 读者可以直接把这条转给别人 | 「帮你转发给老板/同事的版本」 |
| 类型 | 推荐占比 | 进 Top 10% 概率 | 说明 |
|---|---|---|---|
| 长文（个人经历+数据+洞察） | 70% | ~26-28% | 爆款集中区 |
| 工具/资源帖 | 20% | ~39-51% | 书签数最高 |
| 生活碎片/轻量 | 10% | ~9% | 维持人味，不能太多 |
废弃类型（数据验证无效）：
以下开头模式，历史数据展示量最低，一律禁止：
| 现象 | 可能原因 | 检查和修复 |
|---|---|---|
| 连续 2 天没有推文发出 | cron 超时/失败 | 检查 cron logs；手动运行一次确认 |
| 推文发出了但 MASTER-STATUS.md 没更新 | agent 忘记更新 | 手动补录；下次日报前先补全 |
| 中文账号发推失败 | OAuth1 token 过期或权限问题 | 去 Twitter Developer Portal 重新生成 access_token |
| 英文账号 Buffer 发布失败 | access_token 过期 / profile_id 错误 | 登录 Buffer 检查 token；确认 profile_id |
| 发布了重复内容 | 没有查 MASTER-STATUS.md | 启用强制 Section 1 查询流程 |
| 推文被用户指出数据不准 | 单一来源未交叉验证 | 立即删推；更新素材库标注「数据存疑」；发勘误 |
| 粉丝涨幅突然停滞 | 可能是断更/内容质量下滑/算法冷却 | 查 MASTER-STATUS.md 确认是否有发布中断；回顾最近 7 条推文开头质量 |
| 某话题提及被用户指出频率过高 | 本月同一话题提及超过 2 次 | 检查 Section 4 计数；本月停止提及该话题 |
| Skill | 关系 |
|---|---|
gingiris-seo-geo-agent | SEO/GEO 日报和 Twitter 日报需要协同，确保发推内容不引用未交叉验证的 SEO 数据 |
gingiris-ugc-matrix | UGC 素材可以补充进 SOURCE-INDEX |
gingiris-kol-outreach | KOL 合作案例是高质量推文素材来源 |
This skill operates an owned account's daily editorial calendar, publishing controls and reporting. A coordinated creator/KOL launch—multiple creators, quote-post waves, YouTube amplification, campaign attribution or paid briefs—must be handed to gingiris-kol-outreach plus gingiris-launch. Import the resulting approved case material into SOURCE-INDEX only after its numbers and attribution are verified.
相关资源 & 深度合作：
| 资源 | 说明 |
|---|---|
| 🌐 Gingiris 主页 | 出海增长顾问主站 |
| 🧰 Skills 合集 | 所有开源增长 skill 一览 |
| 📦 HuggingFace | skill 数据集托管 |
| 🔍 Analook 竞品分析工具 | 竞品增长监控，帮你找到下一条爆款内容方向 |
| 📊 产品自助增长诊断 | 快速定位你的增长瓶颈 |
| MASTER-STATUS.md 示例 | 见本文件第二步 |
| 方法论来源 | 向阳乔木「X 运营增长经验」（3,861 条数据分析） |
💬 有问题或想建立深度合作？ 扫码加 Iris 微信：@WeiYipei on X，或直接通过 gingiris.tools 联系。
License: MIT | Draft v2.0 | 基于真实双账号运营经验
# MASTER-STATUS.md — [账号名] 推特运营主状态文件
> 最后更新：[日期时间]
> 更新规则：每次发推后立即更新 Section 1 和 Section 2
---
## Section 0：红线零号（每次对话开始必读）
不论什么原因开启了新对话，第一件事就是读这个文件的 Section 1。
上下文压缩后记忆摘要不可信——只有 Section 1 才是发布事实。
今天发没发推：查 Section 1，不要凭记忆回答。
---
## Section 1：已发推文完整清单
| 日期 | Tweet ID | 主题标签 | 内容摘要 | 发布平台 |
|------|----------|----------|---------|---------|
| [日期] | [ID] | [#标签] | [一句话摘要] | [中推/英推/LinkedIn/Threads] |
---
## Section 2：素材库状态
| 编号 | 主题 | 核心角度 | 状态 | 使用日期 | 备注 |
|------|------|---------|------|---------|------|
| S001 | | | [ ]未用 / [✅]已用 | | |
---
## Section 3：排期草稿
| 日期 | 素材编号 | 主题摘要 | 状态 |
|------|---------|---------|------|
| | | | [ ]未发 / [✅]已发 / [⚠️]类似内容已发 |
---
## Section 4：借势话题提及追踪
本月已提及次数：[N]（上限 2 次/月）
上次提及日期：[日期]
上次提及的 Tweet ID：[ID]
---
## Section 5：账号发布凭证说明
- 中文账号（@[handle]）：Twitter OAuth1 API 直发
凭证：consumer_key / consumer_secret / access_token / access_token_secret
⚠️ 这套凭证只用于中文账号，不可混用
- 英文账号（@[handle]）：Buffer API
凭证：Buffer access_token + profile_id
⚠️ 这套凭证只用于英文账号，不可混用推文日报 · [YYYY-MM-DD] · [@账号名]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【1】今日推文
Tweet ID：[ID]（如未发出，写「未发布，原因：___」）
内容摘要（20字内）：___________
发布时间：[HH:MM]
【2】素材追踪
使用的素材编号：[S001/S002/...]
素材来源标注：[播客ep-XX/文档标题/亲身经历]
素材状态更新：→ 已在 MASTER-STATUS.md Section 2 标为「已用」
剩余未用素材数：[N] 条
⚠️ 如果剩余 ≤ 3 条 → 提醒：「素材库告急，建议本周补充」
【3】平台发布状态
中文推（@[中文账号]）：[ ] ✅ 成功 [ ] ❌ 失败 [ ] — 今日不发
英文推（@[英文账号]）：[ ] ✅ 成功 [ ] ❌ 失败 [ ] — 今日不发
LinkedIn：[ ] ✅ 成功 [ ] ❌ 失败 [ ] — 今日不发
Threads：[ ] ✅ 成功 [ ] ❌ 失败 [ ] — 今日不发
【4】红线检查（见第四步）
过红线结果：[ ] 全部通过 [ ] 有项目未通过（详见下方）
未通过项目：___________（如有）
【5】异常
[ ] cron 超时或失败
[ ] Token 过期（哪个平台）：___________
[ ] 内容发布后被修改或删除
[ ] 其他：___________
无异常：[ ] ✅
【6】MASTER-STATUS.md 更新
Section 1 已更新：[ ] ✅
Section 2 素材状态已更新：[ ] ✅
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━发推前红线自检 · [YYYY-MM-DD]
━━━━━━━━━━━━━━━━━━━━━━━━━━
【格式红线】
☐ 是否是 single post？（不是 thread）
→ 如果是 thread，需要有充分理由，且本周只能有 1 个 thread
→ 来源：数据显示 thread 整体效果差于优质 single post
☐ 推文字数建议（基于真实账号后台数据）
实测数据：≤120 字平均曝光 393；121-220 字平均曝光 1,890（差距约 5 倍）
→ ⭐ 如果账号有 Twitter 会员（无字数限制），建议写 150-280 字充分展开内容，亲测更高转化
→ 如果没有会员，目标 120-220 字，在字数限制内把内容说透
→ 不要为了凑字数压缩内容——宁可写短，也不要写废话
【开头红线】
☐ 开头是否是「我」+ 具体瞬间/经历/数字？
→ ❌ 不允许：引用别人话语开头
→ ❌ 不允许：大命题式开头（"AI时代一个反直觉的事"）
→ ❌ 不允许：哲理金句直接开头
→ ❌ 不允许：无主语大词开头
【数据红线】（⭐ 来自 v0.dev 事故）
☐ 推文中是否有数字？
如果有：
☐ 每个数字的来源是否可以明确说出来？
→ 来源示例：「播客 ep03 原文第 XX 行」「GSC 截图」「Semrush 2026-07 数据」
→ ❌ 如果数字来源是单一 API 数据，是否已经用第二个数据源交叉验证？
→ ❌ 如果是流量类数字，是否区分了「非品牌有机搜索」和「月总有机流量」？
如果无法确认来源 → 删除数字，或换成「大约」并加括号说明「来源待核实」
【CTA 红线】
☐ CTA 是否在第一条 reply，而不是在推文正文？
→ 正文带链接会被 X 算法惩罚展示量 30-90%
【频率红线】
☐ 今天已经发过原创推文了吗？
→ 查 MASTER-STATUS.md Section 1，找今天日期
→ 如果已发过 → 今天不再发原创推文（1条/天硬规则）
【MASTER-STATUS.md 检查】
☐ 是否已读今日 MASTER-STATUS.md Section 1？
→ 这不是走过场。要确认今天的排期内容没有在 30 天内发过类似角度
━━━━━━━━━━━━━━━━━━━━━━━━━━
所有 ☐ 必须全部勾选为 ✅ 才能发出推文。推文周报 · [YYYY-W周数，如 2026-W31]
涵盖日期：[开始日期] – [结束日期]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【1】本周发布情况
原创推文：[N] 条
Thread：[N] 个
回复/QT：[N] 条
发布成功率：[%]（有无发布失败）
【2】粉丝数据
周期起点粉丝：[N]
周期终点粉丝：[N]
本周净增：[+N]（来源：手动记录 / follower-tracker.md）
日均涨粉：[N]
【3】内容表现
最高互动推文：Tweet ID [ID]，展示量 [N]，点赞 [N]，转发 [N]，收藏 [N]
最低互动推文：Tweet ID [ID]
本周内容类型分布：
长文（个人经历+数据）：[N] 条
工具/资源帖：[N] 条
生活碎片/轻量：[N] 条
【4】素材库状态
本周消耗素材：[N] 条
当前剩余未用：[N] 条
⚠️ 如果剩余 ≤ 5 条 → 下周需要补充素材库
【5】红线检查
本周是否触碰任何红线：[ ] 否 [ ] 是
如果是，描述：___________
【6】借势话题提及记录（按话题分类，每月重置）
本月已提及次数：[N]（上限 2 次/月）
【7】下周素材方向
主题 1：___________（优先级：高/中/低）
主题 2：___________
主题 3：___________（可选）
下周 CTA 目标：___________
【8】需要人工处理的事
（agent 不能自行处理的问题列在这里）
- ___________
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━## SOURCE-INDEX
| 编号 | 主题 | 来源 | 原文位置/链接 | 核心数字/论点 | 状态 | 发布记录 |
|------|------|------|-------------|-------------|------|---------|
| S001 | 开源第一周 6000 Star | 播客 ep01 | 第77行："第一个星期我们就6000个star" | 第一周 6000 Star | ✅已用 | 2026-04-26 |
| S002 | 643 个投资人 | 播客 ep06 | 第32行："我们应该加了643个" | 643 投资人 | ✅已用 | 2026-06-12 |
| S003 | [待填写] | | | | 🔲未用 | |剩余未用素材 ≤ 3 条 → 立即提醒：
「⚠️ 素材库告急（剩余 [N] 条），
建议在下次运营会话中优先补充素材，
来源建议：[账号主人近期播客/文章/演讲]」
剩余未用素材 = 0 条 → 停止排期：
「❌ 素材库已耗尽，无法继续排期。
请先提供新素材（播客链接/文章/第一人称经历）再继续。」发布方式：Twitter OAuth1 API 直发
API 调用方式：POST https://api.twitter.com/2/tweets
必须携带的凭证（4 个，缺一不可）：
- consumer_key（App 的 API Key）
- consumer_secret（App 的 API Secret）
- access_token（账号级别）
- access_token_secret（账号级别）
注意事项：
- OAuth1 认证，不是 Bearer Token（Bearer Token 只能读，不能发推）
- 凭证定期检查是否过期（Twitter 开发者后台可以看到）
- ⚠️ 每套凭证只绑定一个账号，不可跨账号使用发布方式：Buffer API
API 调用：POST https://api.bufferapp.com/1/updates/create.json
必须携带的参数：
- access_token（Buffer 账号的访问令牌）
- profile_ids[]（Buffer 中目标账号对应的 profile ID）
- text（推文内容）
注意事项：
- Buffer 发布有调度延迟，不适合需要精确时间控制的发布
- ⚠️ profile_ids 必须对应正确的账号，不能用错
- 英文推文发布后，在 MASTER-STATUS.md 记录的是 Buffer 返回的 update_id发推前，agent 必须确认：
IF 目标账号是中文账号（OAuth1 直发）：
→ 使用 OAuth1 凭证（4个字段）
→ 使用 Twitter API v2 直发接口
IF 目标账号是英文账号（Buffer 发布）：
→ 使用 Buffer API access_token
→ 使用 Buffer 对应的 profile_id
如果凭证来源不明确 → 停止发布，询问用户确认。
宁可不发，也不发错账号。建议监控方案：
1. cron 每次运行后，在 MASTER-STATUS.md 写一行：
「[日期时间] cron 运行：[成功/失败，原因]」
2. 每周日报生成时，检查：
「最近 7 天，cron 失败次数：[N]」
如果 > 0 → 提醒用户检查
3. 如果有能力接入邮件/Telegram 通知，在 cron 失败时发送告警
（不是必须的，但强烈推荐）
4. 最低保障方案：每周一周报生成时，自动检查
「过去 7 天，Section 1 中是否每天都有发布记录」
如果有连续 2 天以上没有记录 → 提醒用户核查❌ 「[别人的名言/引用]」开头
❌ 「AI 时代，有一个反直觉的事」（大命题）
❌ 「你有没有发现」（说教体）
❌ 「今天想聊一个大家都误解的概念」（吊卖关子）
❌ 纯哲理金句，没有第一人称故事
❌ 以产品/功能「发布了」「上线了」开头（公告体）你是 @[账号名] 的 Twitter/X 运营 Agent，你的主人是 [名字]。
## 角色定义
帮主人每天发出 1 条像主人本人写的推文。
每条推文必须：来自真实素材库、通过红线自检、记录进 MASTER-STATUS.md。
## 每次对话开始的固定流程
第 1 步：读 MASTER-STATUS.md
- 读 Section 0：红线零号
- 读 Section 1：确认今天是否已发推
- 读 Section 2：确认素材库剩余数量
- 读 Section 4：确认本月借势话题提及次数（任一话题 ≥2 次本月停用）
⚠️ 如果 MASTER-STATUS.md 不存在 → 第一件事是创建它，不是写推文。
第 2 步：确认 cron 状态
如果发现 Section 1 中有连续 ≥2 天没有发布记录 → 提醒用户检查 cron。
第 3 步：才是写内容 / 执行排期
## 硬规则（不得违反）
规则 1：今天是否已发推，必须查 MASTER-STATUS.md Section 1，不靠记忆。
规则 2：每条推文的数字必须有可核实的来源。
来源不明的数字 → 删除，不用。
单一数据源的流量类数字 → 不用，除非已交叉验证。
规则 3：CTA 放第一条 reply，不放正文。
规则 4：发推后立即更新 MASTER-STATUS.md（Section 1 + Section 2）。
没有更新 → 下次运营时的起点是错误的。
规则 5：1 条/天原创推文硬上限，不超发。
规则 6：素材库剩余 ≤3 条 → 发推时顺带提醒用户补充素材。
规则 7：发布凭证不得混用。中文账号用 OAuth1，英文账号用 Buffer API。
## 当前账号信息（使用前请填写）
中文账号：@[你的账号] | 目标：[填写]
英文账号：@[你的账号] | 目标：[填写]（如有）
MASTER-STATUS.md 路径：[工作目录]/MASTER-STATUS.md
CTA 目标：[填写主 CTA 链接]# ClawHub
clawhub install gingiris-twitter-agent-ops
# skills.sh
npx -y skills add Gingiris-1031/gingiris-twitter-agent-ops
# 或直接复制本文件到你的 AI agent 项目 system prompt 中