v2.3.0 to v2.3.1

35 added, 712 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

---
name: gingiris-twitter-agent-ops
description: 'Operate evidence-led X/Twitter and related social workflows: original-source intake, voice calibration,
single-post or thread selection, reviewed drafts, authorized publishing, delivery readback and measured follow-up.
Use for social operations, content planning, publishing checks, analytics and cross-platform adaptation. 适用于社媒运营、文风校准、内容规划、发布回读与数据复盘;区分草稿、发布授权和真实结果,按账号与任务选择格式,不把历史经验当通用平台规则。'
metadata:
- version: 2.3.0
+ version: 2.3.1
when_to_use: '当用户需要系统性运营 Twitter/X 账号时使用。适用于:
- 用 AI Agent 代写/代发推文
- 建立可持续的推文内容系统(素材库 + 排期)
- 同时运营中文和英文账号
- 需要数据追踪(粉丝变化/互动分析/内容复盘)
- 防止 AI 代运营中的常见事故(数据不准、断更、风格漂移)
'
tags:
- twitter
- x-twitter
- social-media
- ai-agent
- automation
- content-marketing
- growth
- scheduling
- analytics
- sop
- daily-report
- weekly-report
- voice-guide
- buffer-api
- oauth1
---
- ## 当前任务权限边界
-
- 分析、诊断、策划或草稿请求只产出报告、草稿和建议。连接账号、读取私有分析、启用付费 API、设置定时任务、发布/删除内容、修改站点或 IndexNow 提交,须在当前会话已授权的账号、目标和范围内进行;已有授权无需重复确认。凭证存在不等于操作或计费授权。故障恢复也遵循同一边界,先检查发送/发布状态,避免重试造成重复。对外数据发送前明确接收服务、内容范围和必要性,不把私有日志或用户原文自动转给其他服务。
-
-
- # Twitter/X Agent 运营 SOP v2.2
-
- > **版本说明**:v2 草稿。v1 给了你整套方法论框架,v2 的重点是:
- > 「已经在跑了,怎么确保不出事、出了事怎么发现、发现了怎么处理」。
-
- ---
-
- ## ⚠️ 开始之前:三个真实事故
-
- 在讲 SOP 之前,先讲三个真实踩过的坑。这三件事决定了 v2 的核心设计。
-
- **事故 1:cron 超时失败 2 周没人发现**
-
- cron job 连续超时失败,没有任何监控机制,整整 2 周没有推文发出。等发现时,粉丝增长已经明显停滞,算法分发也已经冷却。
- → **v2 修复**:强制日报机制,发推后必填,缺了就是异常信号。
-
- **事故 2:v0.dev 流量数据相差 17 倍,被用户公开指出**
-
- 推文中引用了单一数据源(DataForSEO)的「非品牌有机搜索」数字,没有交叉验证,被 @gefei55(哥飞)等用户公开指出数据不准,差了整整 17 倍。
- → **v2 修复**:红线自检中加入「数字来源可查」强制检查项,无来源数字不发。
-
- **事故 3:某一话题提及频率过高,被用户指出「天天蹭流量」**
-
- 某段时期内容过度集中在同一品牌/话题上,用户公开反馈感觉是在持续蹭热度,而不是真正分享。
- → **v2 修复**:任何借势话题每月提及上限 1-2 次,在发推前检查本月该话题已出现次数。
-
- ---
-
- ## 第一步:开局 Context 收集(对话式,必须完成)
-
- 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) 以上都有,但最重要的是 ___
-
- → 先读取发布器能力。只有发布器已验证能创建并核验 reply 时,才允许采用 reply CTA;否则 CTA 必须放根帖正文。正文链接可能影响分发,但这是需要实测的权衡,不得写成未经当前账号验证的固定降权比例。
-
- ---
-
- ### 全部收集后:输出状态判断
-
- ```
- 📊 当前状态:
- - 账号:[@handle],当前 [X] 粉
- - 发布机制:[OAuth1 直发 / Buffer / 手动]
- - 素材库:[N] 条可用
- - 上周发布:[有记录 / 无记录,需建 MASTER-STATUS.md]
- - 内容方向:[用户给的 1-2 件事]
- - 本阶段 CTA:[目标 + 链接]
-
- → 接下来做什么:[3 步以内]
- ```
-
- ---
-
- ### 判断矩阵(Agent 内部参考)
-
- | 情况 | 判断 | 处理方式 |
- |------|------|---------|
- | cron 状态不确定 | 🚨 紧急 | 先检查 cron,确认正常再开始内容工作 |
- | 素材库 ≤ 3 条 | ⚠️ 预警 | 本次运营优先补充素材库,不排期 |
- | 素材库为空 | 🚨 阻塞 | 必须先建素材库才能排期 |
- | 上周发布记录缺失 | ⚠️ 提醒 | 让用户打开 MASTER-STATUS.md 核查 |
- | MASTER-STATUS.md 不存在 | 🚨 首次运营 | 本次任务先建立 MASTER-STATUS.md |
-
-
- ## 第二步:MASTER-STATUS.md — 唯一真相来源
-
- **这是整个系统中最重要的文件。** 任何对话开始前,任何推文发出前后,都必须读写这个文件。
-
- ```
- MASTER-STATUS.md 路径:[工作目录]/MASTER-STATUS.md
- ```
-
- ### 为什么这个文件不可缺少
-
- AI 的上下文会被压缩、重置、遗忘。压缩后的记忆摘要不可信——它不会告诉你「今天发没发推」,它只会给你一个看起来合理但可能错误的答案。
-
- **只有 MASTER-STATUS.md 是事实。**
-
- 这个教训在运营中被纠正了不止 5 次,每一次出问题都是因为没有在对话开始时读这个文件。
-
- ### MASTER-STATUS.md 最小结构
-
- ```markdown
- # 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
- ⚠️ 这套凭证只用于英文账号,不可混用
- ```
-
- ---
-
- ## 2.5 英文三平台配图发布流水线
-
- 英文三平台内容还必须通过“证据与平台适配门”:真实素材优先,保留原文、上下文、归属、时间范围、隐私与核验状态;内容组合覆盖个人认知、脱敏顾问案例、开源/全球 GTM、Tools & Skills 四条主线。四条主线是组合约束,不是机械轮换,也不要求每条内容都植入 Skill。
-
- 内容审与发布审分开:前者检查来源、归属、隐私、人声化与平台原生改写;后者检查渠道健康、自然日日锁、CTA、附件、最终页面与发布回执。同一来源可以共用证据卡和视觉,但 X、LinkedIn、Threads 不得复制同一正文。
-
- CTA 默认放根帖正文。不得继承“统一放首评”的旧规则,也不得堆叠不相关入口。精确时间地点、括号、破折号、数字和表格均为可选表达工具,不设机械数量,不为满足文风模式补造细节。历史数字、第三方案例和平台规律须重新核验来源、日期、归属及公开权限。
-
- 详细门禁见 [三平台配图发布参考](references/three-platform-visual-publishing.md)。
-
- 当任务同时运营 X、LinkedIn、Threads 时,按以下闭环执行。更详细的发布与故障处理见 [三平台配图发布参考](references/three-platform-visual-publishing.md)。
-
- ### 一个证据卡,三份平台原生文案
-
- - X:具体、紧凑,先验证当前发布器实际字数能力。
- - LinkedIn:独立长文,补足真实背景、已验证数据、判断过程、适用边界和执行动作;禁止把 X 文案机械拉长。
- - Threads:默认控制在 500 字符以内,让视觉承担一部分解释。
- - 三个平台可共用同一张核心视觉,但正文不得直接复制。
- - CTA、URL、Skill 安装命令必须保留在根帖正文;图片里的命令只用于识别和保存,不能替代可复制文本。
-
- ### 三平台默认配图
-
- 1. 默认制作 4:5 竖图,优先 1080×1350 或等比例输出。
- 2. 图片必须对应当日证据卡,可使用证据卡、简洁流程图、案例拆解卡或原创编辑插画。
- 3. Skill 内容的图片可加入核心观点、Skill 名称和逐字准确的 `npx -y skills add ...` 指令。
- 4. 发布前核对拼写、命令、裁切、移动端可读性、事实一致性和脱敏边界。
- 5. 图片不得包含未经验证的数据、客户标识、内部截图、私密界面或可反向识别组合。
-
- ### Buffer 图片资产与发布门
-
- - 本地文件不能直接证明 Buffer 能附图。API 图片必须使用稳定、公开且无需登录的 URL。
- - 先验证 URL 最终响应为 HTTP 200 且 `Content-Type` 是目标图片类型;重定向后 404 视为失败。
- - 使用 `assets: [{ image: { url } }]` 创建 X、LinkedIn、Threads 三个平台的图片帖。
- - 发布前必须依次完成:读取 `MASTER-STATUS.md` → Buffer 只读巡检 → Asia/Shanghai 日锁 dry-run → 字数与 CTA 检查 → 图片 URL 检查 → 发布脚本 dry-run。
- - 只有用户明确授权发布后才能执行写入。一次写入后,不因 `sending` 再建重复帖子。
- - `error` 只记录,不自动重试、不改期;发生部分成功时停止并逐平台报告。
-
- ### 完成标准
-
- 只有同时满足以下条件才可报告“已发布”:
-
- 1. Buffer 回读状态为 `sent`,不是 `scheduled` 或 `sending`;
- 2. 回读的附件 MIME 类型与目标图片一致;
- 3. 得到真实 `externalLink`;
- 4. 五分钟内更新 `MASTER-STATUS.md` 和素材状态;
- 5. 10–15 分钟、2h、24h、7d 的检查进入运营日志。
-
- ## 第三步:推文日报(每次发推后必填)
-
- **强制规则:推文发出后 5 分钟内完成日报,不得拖延。**
-
- 日报的作用:
- 1. 标记素材为「已用」,防止重复发布
- 2. 记录发布状态,作为后续周报数据来源
- 3. 立即捕获发布异常(token 过期、发布失败等)
-
- ### 日报模板
-
- ```
- 推文日报 · [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 素材状态已更新:[ ] ✅
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- ```
-
- ---
-
- ## 第四步:红线自检 Checklist(发推前 agent 必须过的关卡)
-
- **发推前,逐项检查。任何一项未通过 → 不发,修改后重检。**
-
- ```
- 发推前红线自检 · [YYYY-MM-DD]
- ━━━━━━━━━━━━━━━━━━━━━━━━━━
- 【格式红线】
- ☐ 格式是否符合本次要求、内容结构、账号证据及发布器能力?single post / thread 均可
- → 说明本次格式选择;频率遵循当前账号计划与用户要求,不设通用每周 thread 配额
- → 历史账号样本只是参考,不证明 thread 普遍较差
-
- ☐ 推文字数建议(基于真实账号后台数据)
- 实测数据:≤120 字平均曝光 393;121-220 字平均曝光 1,890(差距约 5 倍)
- → 如果账号有 Premium 长帖能力,仍需确认当前发布器/API 实际接受的长度;账号能力不等于 Buffer、脚本或 API 能力
- → 如果没有会员,目标 120-220 字,在字数限制内把内容说透
- → 不要为了凑字数压缩内容——宁可写短,也不要写废话
-
- 【开头红线】
- ☐ 开头是否是「我」+ 具体瞬间/经历/数字?
- → ❌ 不允许:引用别人话语开头
- → ❌ 不允许:大命题式开头("AI时代一个反直觉的事")
- → ❌ 不允许:哲理金句直接开头
- → ❌ 不允许:无主语大词开头
-
- 【数据红线】(⭐ 来自 v0.dev 事故)
- ☐ 推文中是否有数字?
- 如果有:
- ☐ 每个数字的来源是否可以明确说出来?
- → 来源示例:「播客 ep03 原文第 XX 行」「GSC 截图」「Semrush 2026-07 数据」
- → ❌ 如果数字来源是单一 API 数据,是否已经用第二个数据源交叉验证?
- → ❌ 如果是流量类数字,是否区分了「非品牌有机搜索」和「月总有机流量」?
- 如果无法确认来源 → 删除数字,或换成「大约」并加括号说明「来源待核实」
-
- 【CTA 红线】
- ☐ CTA 是否能由当前发布器完整交付并在发布后核验?
- → 发布器不能创建 reply:把链接、安装指令或行动提示放进根帖正文
- → 发布器已验证能创建 reply:正文 CTA 与 reply CTA 作为实验变量,不把历史经验写成平台固定规则
- → 安装指令发布前先验证仓库/包存在;附件发布前验证上传成功或公开 URL 返回 200 和正确 Content-Type
- → 禁止写“见首条评论/回复”,然后只发布根帖
-
- 【英文人声化红线】(英文账号必查)
- ☐ 是否从原始事件和动作重新写成英文,而不是逐句翻译中文框架?
- → 删除 `useful signal`、`current option`、`core insight` 等不必要的抽象名词
- → 优先写人做了什么、看到了什么、下一步改了什么
- → 大声读一遍;像咨询报告、PPT 标题或“语法正确但没人这样说”的句子必须重写
- → CTA 也必须像正文的一部分,不能在结尾突然切换成营销口号
-
- 【频率红线】
- ☐ 今天已经发过原创推文了吗?
- → 查 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 不能自行处理的问题列在这里)
- - ___________
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- ```
-
- ---
-
- ## 第六步:素材库建设与管理
-
- ### 什么是素材库
-
- 素材库是推文内容的原料仓库。所有推文必须来自素材库中已有的素材,agent 不得无中生有。
-
- 素材来源:
- - **一手素材**:账号主人的播客/访谈/文章/社交媒体原帖
- - **数据来源**:可被核实的公开数据(注明来源和日期)
- - **亲身经历**:真实发生过的事(不能是推理或假设)
-
- ### 素材库结构(SOURCE-INDEX)
-
- ```markdown
- ## SOURCE-INDEX
-
- | 编号 | 主题 | 来源 | 原文位置/链接 | 核心数字/论点 | 状态 | 发布记录 |
- |------|------|------|-------------|-------------|------|---------|
- | S001 | 开源第一周 6000 Star | 播客 ep01 | 第77行:"第一个星期我们就6000个star" | 第一周 6000 Star | ✅已用 | 2026-04-26 |
- | S002 | 643 个投资人 | 播客 ep06 | 第32行:"我们应该加了643个" | 643 投资人 | ✅已用 | 2026-06-12 |
- | S003 | [待填写] | | | | 🔲未用 | |
- ```
-
- ### 素材库管理规则
-
- **标记规则**:
- - 发推后立即在 MASTER-STATUS.md Section 2 将对应素材标为「✅已用」
- - 已用素材不得在 30 天内再次使用相同核心论点
- - 素材可以「换角度」复用,但必须标注原素材编号和新角度
-
- **预警规则**:
- ```
- 剩余未用素材 ≤ 3 条 → 立即提醒:
- 「⚠️ 素材库告急(剩余 [N] 条),
- 建议在下次运营会话中优先补充素材,
- 来源建议:[账号主人近期播客/文章/演讲]」
-
- 剩余未用素材 = 0 条 → 停止排期:
- 「❌ 素材库已耗尽,无法继续排期。
- 请先提供新素材(播客链接/文章/第一人称经历)再继续。」
- ```
-
- **数据核实规则**:
- - 同一件事在不同场合说的数字可能有出入(如「3天 6000 Star」vs「第一周 6000 Star」)
- - 取最可靠的版本,在素材库中标注「已核实,以[来源]为准」
- - 不确定的数字不用——宁可删掉数字,也不用错误数字
-
- ---
-
- ## 第七步:账号发布机制(双账号双凭证)
-
- **这是一个不允许搞混的硬规则。**
-
- ### 中文账号(OAuth1 直发)
-
- ```
- 发布方式: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 发布)
-
- ```
- 发布方式:Buffer API
- API 调用:使用当前已配置且经过验证的 Buffer API/GraphQL 集成;不要从旧文档假设固定 endpoint
-
- 必须携带的参数:
- - access_token(Buffer 账号的访问令牌)
- - profile_ids[](Buffer 中目标账号对应的 profile ID)
- - text(推文内容)
-
- 注意事项:
- - Buffer 发布有调度延迟,不适合需要精确时间控制的发布
- - ⚠️ profile_ids 必须对应正确的账号,不能用错
- - 英文推文发布后,在 MASTER-STATUS.md 记录的是 Buffer 返回的 update_id
- - 发布前生成一份能力清单:根帖、reply、长帖、图片、PDF/Document 分别标记 `verified / unsupported / unknown`
- - `unknown` 按不可用处理。不得让文案依赖尚未验证的能力
- - 当前集成只能创建根帖时,所有 CTA 必须进入根帖正文
- - 本地文件存在不等于附件可发布;必须在最终平台或 Buffer 返回结果中核验附件
- ```
-
- ### 凭证混用预防规则
-
- ```
- 发推前,agent 必须确认:
-
- IF 目标账号是中文账号(OAuth1 直发):
- → 使用 OAuth1 凭证(4个字段)
- → 使用 Twitter API v2 直发接口
-
- IF 目标账号是英文账号(Buffer 发布):
- → 使用 Buffer API access_token
- → 使用 Buffer 对应的 profile_id
-
- 如果凭证来源不明确 → 停止发布,询问用户确认。
- 宁可不发,也不发错账号。
- ```
-
- ### Cron 监控机制
-
- **来自事故经验**:cron 超时失败可以连续 2 周没人发现。
-
- ```
- 建议监控方案:
- 1. cron 每次运行后,在 MASTER-STATUS.md 写一行:
- 「[日期时间] cron 运行:[成功/失败,原因]」
-
- 2. 每周日报生成时,检查:
- 「最近 7 天,cron 失败次数:[N]」
- 如果 > 0 → 提醒用户检查
-
- 3. 如果有能力接入邮件/Telegram 通知,在 cron 失败时发送告警
- (不是必须的,但强烈推荐)
-
- 4. 最低保障方案:每周一周报生成时,自动检查
- 「过去 7 天,Section 1 中是否每天都有发布记录」
- 如果有连续 2 天以上没有记录 → 提醒用户核查
- ```
-
- ---
-
- ## 第八步:内容创作方法论(来自真实账号 3,861 条推文数据分析)
-
- 这一节是 v1 的精华提炼,在 v2 中保留。数据来自向阳乔木的 X 运营研究。
-
- ### 四省模型(内容价值来自「帮读者少走几步」)
-
- | 省什么 | 具体来说 | 内容示例 |
- |--------|---------|---------|
- | **省搜索** | 读者不用在信息海里找入口 | 「这 10 个工具的入口在这里」 |
- | **省理解** | 读者不用自己猜复杂概念 | 「用一张图解释 PLG 是什么」 |
- | **省试错** | 读者不用把坑全踩一遍 | 「我已经踩了这些坑,你不用踩了」 |
- | **省表达** | 读者可以直接把这条转给别人 | 「帮你转发给老板/同事的版本」 |
-
- ### 内容类型权重(来自实战数据)
-
- | 类型 | 推荐占比 | 进 Top 10% 概率 | 说明 |
- |------|---------|---------------|-----|
- | 长文(个人经历+数据+洞察)| 70% | ~26-28% | 爆款集中区 |
- | 工具/资源帖 | 20% | ~39-51% | 书签数最高 |
- | 生活碎片/轻量 | 10% | ~9% | 维持人味,不能太多 |
-
- **废弃类型**(数据验证无效):
- - 哲理金句短文(进 Top 10% 概率仅 ~7%,周均展示量废弃后 +266%)
- - 无依据地固定 thread 或 single post;按当前任务与账号样本选择
-
- ### 黄金区间
-
- - **字数**:120-220 字可作为历史样本参考,不是平台上限;Premium 长帖先验证账号和发布器能力,再决定长度
- - **开头**:「我」+ 具体经历/数字/瞬间(6 条爆款全部第一人称)
- - **时间**:固定时段,北京时间 14:00-15:00 或 17:00-18:00
- - **CTA**:必须匹配发布器能力。不能可靠创建 reply 时放在根帖正文;能创建 reply 时再把位置作为 A/B 测试变量
-
- ### 死亡开头黑名单
-
- 以下开头模式,历史数据展示量最低,一律禁止:
-
- ```
- ❌ 「[别人的名言/引用]」开头
- ❌ 「AI 时代,有一个反直觉的事」(大命题)
- ❌ 「你有没有发现」(说教体)
- ❌ 「今天想聊一个大家都误解的概念」(吊卖关子)
- ❌ 纯哲理金句,没有第一人称故事
- ❌ 以产品/功能「发布了」「上线了」开头(公告体)
- ```
-
- ---
-
- ## Agent 系统提示词(完整版)
-
- ```
- 你是 @[账号名] 的 Twitter/X 运营 Agent,你的主人是 [名字]。
-
- ## 权限边界
- 仅在用户授权的账号、日期和发布范围内执行;分析或草稿请求不得发布。凭证不等于授权。恢复任务先检查真实发布状态,不盲目重试。删除或勘误同样须在授权范围。
-
- ## 角色定义
- 帮主人每天发出 1 条像主人本人写的推文。
- 每条推文必须:来自真实素材库、通过红线自检、记录进 MASTER-STATUS.md。
-
- ## 每次对话开始的固定流程
-
- 第 1 步:读 MASTER-STATUS.md
- - 读 Section 0:红线零号
- - 读 Section 1:确认今天是否已发推
- - 读 Section 2:确认素材库剩余数量
- - 读 Section 4:确认本月借势话题提及次数(任一话题 ≥2 次本月停用)
-
- ⚠️ 如果 MASTER-STATUS.md 不存在 → 第一件事是创建它,不是写推文。
+ # Social Account Operations / 社媒账号运营
- 第 2 步:确认 cron 状态
- 如果发现 Section 1 中有连续 ≥2 天没有发布记录 → 提醒用户检查 cron。
+ Turn source-backed material into usable drafts, and operate publishing only within the user's authorized scope. Follow the requested language, channel and format. An account's historical tactics are not universal platform rules.
- 第 3 步:才是写内容 / 执行排期
+ ## Choose the job first / 先判断任务
- ## 硬规则(不得违反)
+ - **Draft or adapt:** use the supplied article, notes or original samples immediately. A publisher, cron job, analytics connection and MASTER-STATUS.md are not prerequisites. If a decisive source is missing, flag it and draft around verified material; never invent the author's experience.
+ - **Voice calibration:** read [voice and format](references/voice-and-format.md). With limited samples, provide provisional rules and a test draft. Topic, language and timing confounds prevent causal claims about style.
+ - **Editorial plan:** use the stated goals and available sources. Offer a schedule as a proposal; do not create an automation merely because a plan contains dates.
+ - **Authorized publication:** verify target account, reviewed text/media, scope, publisher capabilities and existing delivery state before writing. User authorization already given need not be requested again.
+ - **Analytics or troubleshooting:** inspect the requested account and time window, distinguish missing data from zero, and report what evidence supports the diagnosis.
- 规则 1:今天是否已发推,必须查 MASTER-STATUS.md Section 1,不靠记忆。
+ ## Minimal context / 最少输入
- 规则 2:每条推文的数字必须有可核实的来源。
- 来源不明的数字 → 删除,不用。
- 单一数据源的流量类数字 → 不用,除非已交叉验证。
+ Use context already supplied: audience, desired action, channel, language, source and deliverable. Ask only for missing information that changes the next action. A single source-linked note is enough for a draft; do not require a large material library or a fixed interview sequence.
- 规则 3:CTA 必须由当前发布器完整交付。发布器不能创建 reply 时,CTA 放根帖正文;禁止承诺不存在的首条评论/回复。
+ For recurring operations also record the account handle/ID, timezone, approved cadence and current integration. Never infer credentials or publisher from the language of a post. Secrets belong in the configured credential store, not in drafts or status files.
- 规则 3.1:英文稿必须从事件、动作和可见证据重新创作,不逐句翻译中文方法论。语法正确但不自然也视为未通过。
+ ## Draft workflow / 起草
- 规则 4:发推后立即更新 MASTER-STATUS.md(Section 1 + Section 2)。
- 没有更新 → 下次运营时的起点是错误的。
+ 1. Make a compact evidence card: source/excerpt, author, date, claim, verification status and allowed use. Private transcripts can calibrate voice but do not authorize public disclosure of their contents. Keep quoted authors separate from the poster.
+ 2. Select one reader problem and one useful takeaway. Preserve meaning before style. Numbers need a traceable source and scope; one authoritative primary source can suffice. Do not combine estimates with incompatible definitions.
+ 3. Choose format according to the user's request. Single post for one compact point; thread when the argument needs sequential parts. For a requested thread, deliver a thread draft even if publishing capability is unknown, marking delivery checks pending. No universal post length, thread count, daily frequency, opening formula or prohibited topic.
+ 4. Adapt to the channel without inventing first-person experience. Choose a CTA only when it serves the reader. If a promised link/comment is not yet deliverable, put the essential information in the draft itself.
+ 5. Deliver the draft plus source notes, uncertain claims, and any media outline. Do not mistake an outline for a rendered asset. State whether author review is still pending.
- 规则 5:1 条/天原创推文硬上限,不超发。
+ Read [three-platform workflow](references/three-platform-visual-publishing.md) only for a multi-platform publishing job. A single-channel draft does not require three variants, an image or a campaign.
- 规则 6:素材库剩余 ≤3 条 → 发推时顺带提醒用户补充素材。
+ ## Publication and recovery / 发布与恢复
- 规则 7:发布凭证不得混用。中文账号用 OAuth1,英文账号用 Buffer API。
+ Within authorized scope, check current platform documentation and the configured connector rather than copying historical API endpoints, credential fields or asset syntax. Maintain a capability table for root post, reply/thread, long text and media: verified / unsupported / unknown. Account subscription capabilities may differ from the publisher's capabilities.
- ## 当前账号信息(使用前请填写)
- 中文账号:@[你的账号] | 目标:[填写]
- 英文账号:@[你的账号] | 目标:[填写](如有)
- MASTER-STATUS.md 路径:[工作目录]/MASTER-STATUS.md
- CTA 目标:[填写主 CTA 链接]
- ```
+ Before a write: verify account identity, final text, attachment accessibility, source permission, timezone/schedule and duplicate state. A local file or successful upload is not proof of a published attachment. Public hosting is a separate disclosure and must be within the authorized scope.
- ---
+ After a write: record the returned ID, read its state, and verify the final public link, text and intended media. Distinguish draft, scheduled, sending, sent, failed and unknown. A log is a record, not the sole authority: reconcile it with platform readback. Never retry an ambiguous write blindly.
- ## 快速故障排查
+ For ongoing operations, use an existing ledger or create a small task-local ledger as needed:
- | 现象 | 可能原因 | 检查和修复 |
- |------|---------|---------|
- | 连续 2 天没有推文发出 | cron 超时/失败 | 检查 cron logs 和实际发布状态;仅在授权范围用 dry-run 诊断,不盲目补发 |
- | 推文发出了但 MASTER-STATUS.md 没更新 | agent 忘记更新 | 手动补录;下次日报前先补全 |
- | 中文账号发推失败 | OAuth1 token 过期或权限问题 | 去 Twitter Developer Portal 重新生成 access_token |
- | 英文账号 Buffer 发布失败 | access_token 过期 / profile_id 错误 | 登录 Buffer 检查 token;确认 profile_id |
- | 根帖写了“见首条回复”但没有回复 | 发布器不支持或未实现 reply 创建 | 停止依赖 reply;把 CTA 放回根帖正文,并更新能力清单 |
- | Premium 账号长帖仍被脚本拒绝 | 发布脚本写死 280 字或当前 API 不支持 | 区分账号能力与发布器能力;先 dry-run,再按已验证上限调整 guard |
- | PDF/Document 在排期中缺失 | 本地文件未上传,或公开 URL 404/类型错误 | 验证 Buffer 原生上传或 URL 200 + Content-Type;失败则阻止发布,不退化成错误格式 |
- | 英文语法正确但读起来很怪 | 从中文框架逐句翻译,抽象名词过多 | 回到原始事件,用“人做了什么→看见什么→改变什么”重写并朗读 |
- | 发布了重复内容 | 没有查 MASTER-STATUS.md | 启用强制 Section 1 查询流程 |
- | 推文被用户指出数据不准 | 单一来源未交叉验证 | 先标注数据存疑并准备纠正方案;只有已有删除/勘误授权时执行,记录操作结果 |
- | 粉丝涨幅突然停滞 | 可能是断更/内容质量下滑/算法冷却 | 查 MASTER-STATUS.md 确认是否有发布中断;回顾最近 7 条推文开头质量 |
- | 某话题提及被用户指出频率过高 | 本月同一话题提及超过 2 次 | 检查 Section 4 计数;本月停止提及该话题 |
+ | Source ID | Account | Reviewed copy/version | Target time + timezone | Publisher ID | State | Public URL | Last verified | Next action |
+ |---|---|---|---|---|---|---|---|---|
+ | [source] | [account] | [version] | [time] | [ID] | [state] | [URL] | [time] | [action] |
- ---
+ Record only credential references, never secrets. A missing ledger does not establish that nothing was published. Check the platform before any recovery action. Recurring monitoring and notifications require a user request; do not auto-create them or send external alerts.
- ## 与其他 Skill 的关系
+ ## Measure and learn / 复盘
- | Skill | 关系 |
- |-------|------|
- | `gingiris-seo-geo-agent` | SEO/GEO 日报和 Twitter 日报需要协同,确保发推内容不引用未交叉验证的 SEO 数据 |
- | `gingiris-ugc-matrix` | UGC 素材可以补充进 SOURCE-INDEX |
- | `gingiris-kol-outreach` | KOL 合作案例是高质量推文素材来源 |
+ Record per-post date, format, topic, language, role, views/impressions if visible, interactions by type, link clicks and downstream outcomes. Define each rate's denominator and time window. If historical follower count is missing, label any current-follower comparison as an approximation. Referral sessions, impressions and follower changes are not interchangeable and do not by themselves prove ROI.
- ### Scope boundary
+ Compare like-for-like posts where possible. Keep alternative explanations such as topic, timing, audience and paid distribution explicit. Report small-sample uncertainty; propose the next bounded experiment instead of enforcing a successful-looking historical recipe.
- 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.
+ ## Useful handoffs
- ---
+ For source-to-multiple-channel adaptation use `gr-social-distill`; for deeper author evidence use `gr-brand-voice-calibration`; for a paid creator campaign use `gingiris-kol-outreach` or `gingiris-ugc-matrix`. These are optional specialists: if absent, finish the bounded requested draft/plan here and identify any additional work separately.
## Install
```bash
- # ClawHub
- clawhub install gingiris-twitter-agent-ops
-
- # skills.sh
- npx -y skills add Gingiris-1031/gingiris-twitter-agent-ops
-
- # 或直接复制本文件到你的 AI agent 项目 system prompt 中
+ npx skills add Gingiris-1031/gingiris-skills --skill gingiris-twitter-agent-ops
```
- **相关资源 & 深度合作**:
-
- | 资源 | 说明 |
- |------|------|
- | 🌐 [Gingiris 主页](https://gingiris.tools/) | 出海增长顾问主站 |
- | 🧰 [Skills 合集](https://gingiris.tools/skills/) | 所有开源增长 skill 一览 |
- | 📦 [HuggingFace](https://huggingface.co/Gingiris) | skill 数据集托管 |
- | 🔍 [Analook 竞品分析工具](https://www.analook.com) | 竞品增长监控,帮你找到下一条爆款内容方向 |
- | 📊 [产品自助增长诊断](https://www.analook.com/growth-audit.html) | 快速定位你的增长瓶颈 |
- | MASTER-STATUS.md 示例 | 见本文件第二步 |
- | 方法论来源 | 向阳乔木「X 运营增长经验」(3,861 条数据分析)|
-
- 💬 **有问题或想建立深度合作?** 扫码加 Iris 微信:[@WeiYipei on X](https://x.com/WeiYipei),或直接通过 [gingiris.tools](https://gingiris.tools/) 联系。
-
- ---
-
- *License: MIT | Draft v2.2 | 基于真实双账号运营经验与三平台配图发布闭环*
-
-
- ## Voice and format calibration / 文风与格式
-
- For best/worst sample analysis or single-post/thread decisions, read [voice and format](references/voice-and-format.md). 现有账号经验有适用范围,不覆盖用户本次语言、平台或格式要求。
+ Completion means the requested draft/plan is usable, or the authorized delivery is verified. Do not report publication or business impact from a draft, API acceptance or self-rating.
<!-- gingiris-community-cta:start -->
## 加入出海社群与购买资料包 · Community & Resources
- **加入出海社群:** 微信添加 **staywildgrow**,留言「**加入社群**」即可。
- **购买资料包:** 微信添加 **staywildgrow**,咨询购买 Gingiris 出海资料包,价格 **599 元人民币**。
- **Join the global growth community:** Add **staywildgrow** on WeChat and send **“加入社群”** (join the community).
- **Get the resource pack:** Add **staywildgrow** on WeChat to purchase the Gingiris global growth resource pack for **CNY 599**.
社群与资料包为可选入口,不影响本开源 Skill 的安装和使用。
The community and paid resource pack are optional; neither is required to install or use this open-source skill.
<!-- gingiris-community-cta:end -->