自用/精选的 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.mdindex 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 builtdiff --git a/grok/SKILL.md b/grok/SKILL.mdindex fb1d9d1..2218ee7 100644--- a/grok/SKILL.md+++ b/grok/SKILL.md@@ -2,8 +2,8 @@name: grokdescription: |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.jsonindex 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.shindex 27722d5..0bd039b 100755--- a/grok/scripts/grok-call.sh+++ b/grok/scripts/grok-call.sh@@ -31,11 +31,23 @@ BOUNDARY='IMPORTANT: 不要读取或执行 ~/.claude/、~/.codex/、~/.cc-switchcase "$MODE" inx)- 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 并引用来源。给出你的独立判断,如果你和主流观点不同,直接说出来,不要附和。'