Skip to content

自用/精选的 Claude Code / Codex 技能:内容创作、客服、市场调研、SEO、Agent 工作流循环、Grok X 实时抓取与评审工具

Python

fix(grok): require native X search evidence

yangliu2060c8bbdd2bd4d3
diff --git a/grok/README.md b/grok/README.md
index d31d6a8..d3ad4fa 100644
--- a/grok/README.md
+++ b/grok/README.md
@@ -1,18 +1,18 @@
# grok-skill
-Let Claude Code call your local **Grok Build** CLI for **real-time X (Twitter) data** — 带 @用户名、点赞/浏览数、链接、时间的真实帖子。grok-build CLI 内部把 X 抓取链(Tavily / Firecrawl / Playwright / opencli + 排序 + 营销过滤 + 结构化输出)调通了,你不用自己拼工具栈;加上复用你的 grok.com 订阅,零额外成本(不像 MCP 方案要 xAI API key)。
+Let Claude Code call your local **Grok Build** CLI for **public X (Twitter) search and real-time discourse sampling**. X mode now explicitly asks Grok to prefer its native X tool family: `x_keyword_search`, `x_semantic_search`, `x_user_search`, and `x_thread_fetch`, with `web_search` / `open_page` for cross-checking. Outputs must include @用户名、post ID、链接、时间、互动数据、短原文摘录和限制说明。复用你的 grok.com 订阅,零额外成本(不像 MCP 方案要 xAI API key)。
## Why this exists
-Claude 自己也能调 Tavily / WebSearch 搜 X,但抓 X 这事得拼对工具(普通 web search 给的是滞后索引)、配排序、过滤营销噪音、整理结构 —— 自己组装很烦。**grok-build CLI 内部已经把这套**(Tavily / Firecrawl / Playwright / opencli + 相关性排序 + 互动加权 + 营销过滤 + 结构化输出)**调好了**。这个 skill 把 grok-build 包装成 Claude Code 的工作流入口,让 "X 上现在怎么说" 一句话直接拿到结构化结果 —— 而不是让 Claude 自己拼工具或拿训练数据糊弄你。
+Claude 自己也能调 Tavily / WebSearch 搜 X,但 X 任务真正需要的是可复核的公共话语采样: 精确关键词、账号限定、日期窗口、thread 上下文、互动数据和原文链接。这个 skill 把 grok-build 包装成 Claude Code 的工作流入口,让 "X 上现在怎么说" 变成一次带检索策略和证据字段的 Grok 调用,而不是让 Claude 自己拼工具或拿训练数据糊弄你。
-> **诚实声明**:grok-build CLI 用的也是 web 工具栈(每次调用 grok 自己会在末尾说出当次用了什么),不是 xAI 内部的 firehose API。本 skill 的真实价值是"**省事 + 省钱**",不是"**独家数据通道**"。
+> **诚实声明**: 这个 skill 通过 Grok CLI 发 prompt,不能像 xAI REST Responses API 那样在请求体里强制声明 `tools: [{ "type": "x_search" }]`。它能做的是把工具选择、证据字段和输出格式写进 prompt,让 Grok 在当前运行时暴露这些 X 工具时优先使用。它不是 firehose,也不能看 DM、私有账号、个人级点赞或书签。
替代方案对比:
| 方案 | 成本 | X 抓取链 | 启动延迟 |
|------|------|---------|----------|
-| **这个 skill(包装本地 grok)** | 0(复用 grok.com 订阅) | ✅ 现成,grok 已调好排序+过滤 | 30s-2min |
+| **这个 skill(包装本地 grok)** | 0(复用 grok.com 订阅) | ✅ Prompt 强制优先用 Grok X 工具族并输出证据字段 | 30s-2min |
| Grok MCP server(`grok-mcp` 等) | xAI API key 按 token 付费 | ✅ 类似(走 xAI API) | <1s |
| Claude + Tavily / Exa 自己拼 | API key 付费 + 你的拼装时间 | ⚠️ 工具有,排序/过滤要自己写 | <1s |
| Claude 训练数据 | 0 | ❌ 截止日期之前 | 0 |
@@ -28,7 +28,7 @@ Grok 通过本 skill 返回(部分):
> 链接:`https://x.com/_catwu/status/2060054180379689074`
> 核心:Anthropic 工程师官宣 Claude Code 动态工作流(dynamic workflows),支持数百并行 sub-agents,内部案例 <10 分钟并行处理数百 A/B test flags。
-带精确互动数 + 链接 + 时间 + 语义摘要 —— 这是普通 web 搜索 API 给不了的。
+带 post ID + 精确互动数 + 链接 + 时间 + 原文摘录 + 语义摘要,这是普通 web 搜索 API 给不了的。
## Requirements
@@ -80,7 +80,7 @@ cp -r smith--skills/grok ~/.claude/skills/
| 场景 | 触发示例 | 模式 |
|------|---------|------|
-| **X 实时抓取(主力)** | "问问 grok,X 上对 Opus 4.8 的真实反馈" | `x` |
+| **X 公共搜索 / 实时话语采样(主力)** | "问问 grok,X 上对 Opus 4.8 的真实反馈,给 post ID 和链接" | `x` |
| **第二意见 / 通用问答** | "grok 第二意见:sqlite 做向量库后端靠谱吗" | `ask` |
| **续接追问** | "继续问 grok,那换 duckdb 呢" | `continue` |
@@ -105,7 +105,9 @@ bash ~/.claude/skills/grok/scripts/grok-call.sh x /tmp/q.txt
- 单次调用 30s-2min(grok 抓 X + 思考慢)
- grok-build 模型固定,不支持 `--effort`(传了会报 400,脚本已不传)
-- X 精确互动数偶尔抓不全,grok 会退化用"传播广度"做 proxy 并说明
+- X 搜索是公共索引采样,不是全量 firehose
+- X 精确互动数可能缺字段,缺失时必须说明
+- X 数据不能单独当事实源;涉及事实判断时必须用网页来源交叉验证
- 续接靠 grok `-c` 标志(最近 session),跨工作目录不保证命中
## How it was built
diff --git a/grok/SKILL.md b/grok/SKILL.md
index fb1d9d1..2218ee7 100644
--- a/grok/SKILL.md
+++ b/grok/SKILL.md
@@ -2,8 +2,8 @@
name: grok
description: |
Grok CLI 包装器 — 让 Claude 调本地 grok-build 获取 X (Twitter) 实时内容。
- grok-build CLI 内部把 X 抓取工作流(Tavily / Firecrawl / Playwright / opencli 等工具 +
- 相关性排序 + 互动加权 + 营销噪音过滤 + 结构化输出)整合好了,开发者不用自己拼。
+ X 模式必须优先驱动 Grok 原生 X 工具族:x_keyword_search、x_semantic_search、
+ x_user_search、x_thread_fetch;必要时再用 web_search/open_page 交叉验证。
返回带 @用户名、点赞/浏览数、链接、时间的真实帖子。复用用户已登录的 grok.com 订阅,
调用零额外成本(不像 MCP 方案要 xAI API key 按 token 付费)。
三模式:x(X 实时抓取,主力)、ask(把 Grok 当独立第二意见)、continue(续接追问)。
@@ -11,10 +11,10 @@ description: |
问问 grok X 上在聊什么、让 grok 搜 X 上对某事的实时讨论、grok 看看 @某账号最近发了什么、
X 上现在怎么说、X 实时热点、X 实时趋势、ask grok what X is saying about、
grok 第二意见、consult grok。
- 排除(不要触发本 skill):写 X 推文 → 用 x-twitter-writer;非实时的历史 X 检索 →
- 用 x-sousuo;泛网络调研 → 用 smart-research。本 skill 的差异点是 grok 把 X 抓取工作流
- 调通了 + 复用订阅零成本,**不是**独家数据通道(grok 内部用的也是 web 工具);
- 没有"实时 X 抓取"诉求时不要用它。
+ 排除(不要触发本 skill):写 X 推文 → 用 x-twitter-writer;大规模历史语料采集 →
+ 用 x-sousuo;泛网络调研 → 用 smart-research。本 skill 的差异点是 Grok 对公共 X 搜索
+ 工具有原生路径,适合可复核的 X 话语采样;不是 firehose,也不是事实裁判。
+ 没有"公共 X 搜索 / X 实时反馈 / thread 上下文"诉求时不要用它。
allowed-tools:
- Bash
- Read
@@ -24,13 +24,21 @@ allowed-tools:
# /grok — Claude 调用 Grok
-主战场是 **X (Twitter) 实时内容**。grok-build CLI 内部用 Tavily / Firecrawl / Playwright /
-opencli 等工具实时抓 X,配上相关性排序、互动加权、营销噪音过滤、结构化输出 —— 整套工作
-流已经调好。对开发者来说 = 现成的 X 抓取专家,省去自己拼工具栈的事。次要场景:把 Grok
-当独立第二意见用。复用 grok.com 订阅,零额外成本(vs MCP 方案要 xAI API key 按 token 付)。
+主战场是 **X (Twitter) 公共搜索与实时话语采样**。x 模式要把任务显式交给 Grok 的 X 工具族:
-> **诚实声明**:grok-build CLI 不是 xAI 内部 firehose API,它内部走的也是上面那些 web 工具。
-> 本 skill 的价值是"省事 + 省钱",不是"独家数据通道"。
+- `x_keyword_search`:精确关键词、账号操作符、日期、互动阈值、Top/Latest 排序
+- `x_semantic_search`:自然语言话题、模糊趋势、观点/情绪采样
+- `x_user_search`:用户或账号发现
+- `x_thread_fetch`:已知 post URL/ID/thread 的上下文抓取
+- `web_search` / `open_page`:事实核验、媒体报道、第三方趋势页补充
+
+次要场景:把 Grok 当独立第二意见用。复用 grok.com 订阅,零额外成本(vs MCP 方案要 xAI API
+key 按 token 付)。
+
+> **诚实声明**:这个 skill 通过 Grok CLI 发 prompt,不能像 REST Responses API 那样在请求体里
+> 强制声明 `tools: [{type: "x_search"}]`。它能做的是把工具选择、证据字段和输出格式写进 prompt,
+> 让 Grok 在当前运行时暴露这些 X 工具时优先使用。它不是 firehose,也不能看 DM、私有账号、
+> 个人级点赞/书签。
所有调用逻辑(filesystem boundary、模式模板、超时、错误处理、临时文件清理)都收敛在
`scripts/grok-call.sh` 一个脚本里。本 skill 只负责:识别模式 → 写 query 文件 → 调脚本 →
@@ -65,9 +73,9 @@ opencli 等工具实时抓 X,配上相关性排序、互动加权、营销噪
解析用户输入决定 `<mode>`,模糊时用 AskUserQuestion 确认:
-- **x**(主力):要 X 实时数据。触发:`/grok x`、"X 上 ..."、"推特上 ..."、"X 热点/趋势"、
- "grok 看看 @某账号"。脚本模板已强制 Live Search + 结构化输出(核心结论 → Top 帖子 →
- 其他观察)+ 互动数据标注。
+- **x**(主力):要公共 X 数据、实时反馈、限定时间窗采样、账号近期动态、具体 thread 上下文。
+ 触发:`/grok x`、"X 上 ..."、"推特上 ..."、"X 热点/趋势"、"grok 看看 @某账号"、
+ "抓这条 X thread"。脚本模板已强制 X 工具选择、证据链接、post ID、时间戳、互动数据和限制说明。
- **ask**:通用问答 / 第二意见,非 X 场景。触发:`/grok` 后跟普通问题、"grok 第二意见"、
"consult grok"。脚本模板开放 web search,要 grok 给独立判断、不附和。
- **continue**:续接最近一次 grok 对话追问。触发:"继续问 grok"、"接着问"。脚本带 `-c`,
@@ -87,11 +95,15 @@ opencli 等工具实时抓 X,配上相关性排序、互动加权、营销噪
- 单纯查代码、改文件 → 用 Claude 自己,别绕道 grok
- 需要多轮深聊(5+ 回合)→ 直接进 grok TUI(终端跑 `grok` 不带参数)更顺手
-- 只要 1-2 条特定帖子且非实时 → Claude 用 Tavily/Exa 也够
-- 写 X 推文 → x-twitter-writer;非实时历史检索 → x-sousuo;泛调研 → smart-research
+- 写 X 推文 → x-twitter-writer
+- 大规模历史语料抓取、批量导出、定时采集 → x-sousuo
+- 泛网络调研、论文/新闻/网页为主 → smart-research
+- 只要读本地代码或改文件 → Claude 自己做,别绕道 grok
## 已知限制
- 每次调用冷启动 3-5s + 抓 X 思考时间,单次可能 30s-2min,属正常
- grok-build 是固定模型,不支持调思考深度(传 `--effort` 会报 400,脚本已不传)
-- X 精确互动数(赞/浏览)因反爬有时抓不全,grok 会退化用"传播广度"做 proxy 并说明
+- X 搜索是公共索引采样,不是全量 firehose
+- X 精确互动数(赞/浏览/转发/回复/书签)可能缺字段,缺失时必须说明
+- X 数据不能单独当事实源;涉及事实判断时必须用网页来源交叉验证
diff --git a/grok/evals/evals.json b/grok/evals/evals.json
index 86c646f..8e6c0bd 100644
--- a/grok/evals/evals.json
+++ b/grok/evals/evals.json
@@ -6,15 +6,40 @@
"id": 1,
"name": "x-mode-realtime-search",
"prompt": "问问 grok,最近 24 小时 X 上关于 AI coding agent 的热门讨论有哪些",
- "expected_output": "走 x 模式:Write 写 query 文件 → 调 grok-call.sh x。返回带 @用户名/大致时间/互动信号的真实 X 帖子,结构化(核心结论→Top帖子→其他观察),grok 原文原样转达不二次总结。",
+ "expected_output": "走 x 模式:Write 写 query 文件 → 调 grok-call.sh x。Prompt 明确要求优先使用 Grok X 工具族,返回带 @用户名/post ID/链接/时间/互动数据/短原文摘录/限制说明的真实 X 帖子证据,结构化(核心结论→检索策略→Top帖子证据→其他观察/噪音→限制与复核方式),grok 原文原样转达不二次总结。",
"files": [],
"assertions": [
{"text": "用 grok-call.sh 的 x 模式调用(mode 参数为 x,非 ask/continue)", "kind": "manual"},
{"text": "query 用 Write 工具落盘后再调脚本,未使用 shell heredoc 拼 prompt", "kind": "manual"},
- {"text": "输出至少包含 3 个带 @ 用户名的 X 帖子引用", "kind": "manual"},
+ {"text": "Grok 输出检索策略,并明确出现 x_keyword_search、x_semantic_search、x_user_search、x_thread_fetch 中至少一个相关工具或等价工具说明", "kind": "manual"},
+ {"text": "输出至少包含 3 个带 @ 用户名、post ID、链接、时间、互动数据和短原文摘录的 X 帖子引用", "kind": "manual"},
{"text": "grok 回复被原样转达(带 ━━━ 分隔),未被 Claude 改写或浓缩", "kind": "manual"}
]
},
+ {
+ "id": 5,
+ "name": "x-mode-thread-fetch",
+ "prompt": "让 grok 抓这条 X thread 的上下文和高质量回复:https://x.com/xai/status/2061510464325206163",
+ "expected_output": "走 x 模式:调 grok-call.sh x。Prompt 应引导 Grok 优先用 x_thread_fetch 抓取给定 post/thread,并返回主帖、父帖或回复上下文、post ID、链接、时间、互动数据和复核方式。",
+ "files": [],
+ "assertions": [
+ {"text": "用 grok-call.sh 的 x 模式调用(mode 参数为 x)", "kind": "manual"},
+ {"text": "Grok 输出检索策略中说明 thread/post URL 场景优先用 x_thread_fetch 或等价 thread 抓取工具", "kind": "manual"},
+ {"text": "输出包含原 post ID、可打开链接、发布时间、互动数据和回复/上下文证据", "kind": "manual"}
+ ]
+ },
+ {
+ "id": 6,
+ "name": "x-mode-account-date-window",
+ "prompt": "用 grok 搜 @karpathy since:2026-06-01 之后关于 agents 的高互动帖子,给 post id 和链接",
+ "expected_output": "走 x 模式:调 grok-call.sh x。Prompt 应引导 Grok 用账号限定、日期窗口和互动信号做公共 X 搜索,并输出检索策略、post ID、链接、时间、互动数据、短原文摘录和限制说明。",
+ "files": [],
+ "assertions": [
+ {"text": "用 grok-call.sh 的 x 模式调用(mode 参数为 x)", "kind": "manual"},
+ {"text": "Grok 输出检索策略中保留 @karpathy、since:2026-06-01 或等价日期窗口", "kind": "manual"},
+ {"text": "输出包含 post ID、链接、发布时间、互动数据和短原文摘录", "kind": "manual"}
+ ]
+ },
{
"id": 2,
"name": "ask-mode-second-opinion",
diff --git a/grok/scripts/grok-call.sh b/grok/scripts/grok-call.sh
index 27722d5..0bd039b 100755
--- a/grok/scripts/grok-call.sh
+++ b/grok/scripts/grok-call.sh
@@ -31,11 +31,23 @@ BOUNDARY='IMPORTANT: 不要读取或执行 ~/.claude/、~/.codex/、~/.cc-switch
case "$MODE" in
x)
- TEMPLATE='用 X (Twitter) 实时数据回答下面的问题。硬性要求:
-- 优先用 Live Search 抓 X 实时内容,不要只靠训练数据;末尾标明数据来源与时效
-- 涉及帖子时附 @用户名、大致发布时间、互动数据(赞/浏览),拿不到精确数字时说明用什么 proxy
+ TEMPLATE='用 X (Twitter) 公共数据回答下面的问题。不要只靠训练数据。
+
+优先使用当前 Grok 运行时暴露的 X 工具族:
+- 精确关键词、账号、操作符、日期、互动阈值、Top/Latest 排序:用 x_keyword_search
+- 模糊话题、观点/情绪、自然语言趋势采样:用 x_semantic_search
+- 用户名不确定或需要找账号:用 x_user_search
+- 用户给出 post URL/ID/thread:用 x_thread_fetch
+- 事实核验、媒体报道、第三方趋势页:用 web_search/open_page 交叉验证
+
+硬性要求:
+- 先说明检索策略:用了哪些工具、查询词/账号、日期窗口、排序或阈值
+- 涉及帖子时必须给 @用户名、post ID、可打开链接、发布时间、公开互动数据;缺哪个字段就写缺失
+- 给短原文摘录,不要只给你的转述
+- 区分证据、推断和事实核验;X 只能代表公共样本,不是事实源
- 区分高信号内容和营销噪音,营销/affiliate 帖单独归类
-- 结构:① 核心结论 3-5 句 → ② Top 帖子 → ③ 其他观察'
+- 如果结果稀疏、查询失败或工具不可用,直接说明,不要编造
+- 结构:① 核心结论 3-5 句 → ② 检索策略 → ③ Top 帖子证据 → ④ 其他观察/噪音 → ⑤ 限制与复核方式'
;;
ask)
TEMPLATE='回答下面的问题。可用 web search 并引用来源。给出你的独立判断,如果你和主流观点不同,直接说出来,不要附和。'