gate-news-communityscan

gate-news-communityscan

通用规则

⚠️ 停止——继续之前，必须阅读并严格遵循共享运行时规则。 在读完所有规则之前，请勿选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md → 另请阅读 info-news-runtime-rules.md，了解 gate-info / gate-news 专属规则（工具降级、报告标准、安全、路由降级、存在 scripts/ 时的技能版本检查，以及旧版包装器路由）。

• 只能调用此技能中明确列出的 MCP 工具。 即使 MCP 服务中存在此处未记载的工具，也不得调用。
• 旧版 / 路由模式： 当步骤 0 输出 __FALLBACK__ 时，只能使用此文件中列出的 MCP 工具。当步骤 0 输出 __ROUTE_CLI__ 时，不得调用这些 MCP 工具；应根据步骤 0 委派给映射的主技能。

社区情绪扫描技能（侧重 X/Twitter）。并行调用可获取 X/Twitter 讨论分析和定量社交情绪数据；大模型将其汇总为社区洞察报告。

触发场景：社区观点、Twitter/X 讨论、KOL 观点、社交情绪等。

技能专属更新： 此目录包含 scripts/update-skill.sh，也可能包含 scripts/update-skill.ps1。上传至市场的 ClawHub 软件包通常不包含 update-skill.ps1（上传页面限制所致）；GitHub / Bitbucket 源代码树则同时包含这两个文件。策略见：info-news-runtime-rules.md §1。以下触发更新步骤是对 gate-runtime-rules.md 的补充；存在脚本时，执行前请按此流程检查版本。

更新检查——对用户的可见性： 版本检查期间的技术故障（脚本缺失、沙盒、网络、非零退出状态、没有可解析的 Result= 行）不得向用户说明；请根据 info-news-runtime-rules.md 继续执行。只有成功的 check / apply 结果才可以概述（包括 update_available / 严格的退出状态 3；这仍属于成功路径，但执行 apply 前必须征得用户确认）。不得从网络自动下载 update-skill.*。.ps1 缺失时的静态参考：规范脚本位于 gate/gate-skills 中的 skills/<name>/scripts/ 目录（<name> 与 frontmatter 中的名称相同）。

---

步骤 0 — 包装器路由探测

此旧版技能是主 CLI 技能 gate-news-intel 的兼容别名。

在触发更新、选择 MCP 工具或运行任何旧版执行工作流之前， 请运行一个确定性 shell 探测：

PRIMARY_SKILL="gate-news-intel"
HAS_PRIMARY=0
for root in \
  "$HOME/.cursor/skills" \
  "$HOME/.codex/skills" \
  "$HOME/.openclaw/skills" \
  "$HOME/.agents/skills" \
  "$HOME/.gemini/antigravity/skills"
do
  if [ -f "$root/$PRIMARY_SKILL/SKILL.md" ]; then
    HAS_PRIMARY=1
    break
  fi
done

if command -v gate-cli >/dev/null 2>&1 && [ "$HAS_PRIMARY" = "1" ]; then
  echo "__ROUTE_CLI__"
else
  echo "__FALLBACK__"
fi

解释：

• __ROUTE_CLI__ → 在此停止。不要运行触发更新或下方的旧版 MCP 部分。请遵循 https://github.com/gate/gate-skills/blob/master/skills/gate-news-intel/SKILL.md 及其操作手册契约。仅传递最低限度的上下文：symbol 和 可选的 time_range。
• __FALLBACK__ → 继续执行触发更新和此文件中的旧版 MCP 工作流。

---

触发时更新（并执行）

默认（PD / 阻塞）： 每次触发时，先运行 check，不要设置 GATE_SKILL_UPDATE_MODE=auto。该脚本只进行比较本地版本与远程版本；如果 Result=update_available，则不会覆盖文件。停止——在执行任何 apply、run 或技能执行之前，先询问用户是否要更新。在沙箱中（例如 Cursor），之后运行 apply 时使用完全 / 所有权限。这符合独立脚本 TEST_REPORT 中的阻塞式更新确认：阻塞由这些 SKILL 说明和仅检查行为共同实现（而非静默自动应用）。

严格检查（Agent / IDE — 建议在运行 check 时使用）： 使用 GATE_SKILL_CHECK_STRICT=1。当 Result=update_available 时，check 会以状态码 3 退出，并打印 GATE_SKILL_CHECK_EXIT=3——它只会停止当前 shell 步骤。硬性规则：询问用户后，结束本轮助手对话；不要在同一条消息中调用 apply、run 或 MCP。run 会在没有用户事先确认的情况下应用更新——阻塞流程中不要在聊天中使用 run；请使用 check → 用户确认 → apply。

步骤 1 — 检查

安装根目录： check / apply 会读取 $DEST/SKILL.md。常见的 $SKILL_ROOT：$HOME/.cursor/skills/<name>/、$HOME/.codex/skills/<name>/、$HOME/.openclaw/skills/<name>/、$HOME/.agents/skills/<name>/、$HOME/.gemini/antigravity/skills/<name>/。单参数模式：当 SKILL.md 存在时，脚本会按此顺序解析 DEST；否则 DEST 为 scripts/../。仅工作区目录树需要使用双参数 check / apply，并显式指定 DEST。

Agent 选择规则（下面带围栏的示例最多运行一个；根据操作系统和 $SKILL_ROOT/scripts/ 下的文件进行选择）：

• **macOS / Linux / WSL / Git Bash：**如果存在 update-skill.sh → 仅使用 Bash 示例。
• **Windows（原生 PowerShell）：**如果存在 update-skill.ps1 → 仅使用 PowerShell 示例。
• Windows（没有 .ps1）（典型的 ClawHub 安装）：如果只有 update-skill.sh → 尝试使用 WSL 或 Git Bash（bash），并采用与 Bash 示例相同的命令格式。如果 bash 不可用或执行失败 → 静默跳过步骤 1（不要向用户显示脚本 stderr 或“版本检查失败”消息）；继续执行技能。
• **两个脚本都不存在：**静默跳过步骤 1；继续执行技能。不要臆造 GATE_SKILL_CONFIRM_TOKEN，也不要运行 apply / revoke-pending。

Bash（阻塞式——不自动更新；Cursor 示例）：

GATE_SKILL_CHECK_STRICT=1 bash "$HOME/.cursor/skills/gate-news-communityscan/scripts/update-skill.sh" check "gate-news-communityscan"

PowerShell：

$env:GATE_SKILL_CHECK_STRICT = '1'
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\gate-news-communityscan\scripts\update-skill.ps1" check "gate-news-communityscan"

结果含义：skipped = 不执行任何操作。update_available = 远程版本较新；采用阻塞流程时，未经用户同意不得应用更新。check_failed = 无法进行比较——根据 info-news-runtime-rules.md 使用当前版本继续；不要向用户透露检查失败的技术细节。

Agent 解析（stdout）：GATE_SKILL_UPDATE_AGENT_ACTION=…。BLOCK_UNTIL_USER_CONFIRMS_UPDATE → 在执行技能前进行步骤 2。CONTINUE_SKILL_EXECUTION → 检查脚本不会阻止执行技能。

步骤 2 — 确认或拒绝（阻塞）

运行时：步骤 2 使用与步骤 1 相同的 shell 类型（Bash 或 PowerShell）。如果跳过了步骤 1，不要运行 apply 或 revoke-pending。

如果为 update_available：

1. 停止——此时不要继续执行。

2. 通知用户（例如有较新版本可用；如有帮助，可进行摘要）。

3. 等待用户回复——此步骤会阻塞。

   硬性规则（Cursor / Agent）：当 check 报告 update_available、BLOCK_UNTIL_USER_CONFIRMS_UPDATE 或严格模式下的 exit 3 时，提出确认请求后结束本轮。只有在用户的下一条消息中，才能运行 apply（用户同意时）或 revoke-pending（用户拒绝时）。在此流程中，不要在运行 check 的同一轮中接着运行 apply。

   • 用户同意 → 在需要时，使用严格模式 check 的 stdout 中的 GATE_SKILL_CONFIRM_TOKEN 运行 apply，然后执行。
   • 用户拒绝 → 运行 revoke-pending，然后在当前安装上执行。

两步门控（严格模式 check）：在 GATE_SKILL_CONFIRM_TOKEN 与 .gate-skill-apply-token 匹配之前，apply / run（未设置 GATE_SKILL_UPDATE_MODE=auto 时）会失败。用户拒绝 → revoke-pending。

GATE_SKILL_CONFIRM_TOKEN="<paste from check stdout>" bash "$HOME/.cursor/skills/gate-news-communityscan/scripts/update-skill.sh" apply "gate-news-communityscan"

bash "$HOME/.cursor/skills/gate-news-communityscan/scripts/update-skill.sh" revoke-pending "gate-news-communityscan"

$env:GATE_SKILL_CONFIRM_TOKEN = '<paste from check stdout>'
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\gate-news-communityscan\scripts\update-skill.ps1" apply "gate-news-communityscan"

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.cursor\skills\gate-news-communityscan\scripts\update-skill.ps1" revoke-pending "gate-news-communityscan"

如果步骤 1 未使用严格模式（没有待处理令牌）：允许在不提供 GATE_SKILL_CONFIRM_TOKEN 的情况下运行 apply。

**如果为 skipped 或 check_failed：**无需执行更新步骤；继续执行。

可选 — GATE_SKILL_UPDATE_MODE=auto

仅用于 CI / 无人值守自动化：在 check 时设置 GATE_SKILL_UPDATE_MODE=auto，脚本会在远程版本较新时立即应用更新——无需用户确认，且与阻塞式更新确认测试不兼容。复现阻塞式 PD 流程时，不要在 check 时使用 auto。

参数

• name：上方 Frontmatter 中的 name；必须与 gate-skills 中的 skills/<name>/ 匹配。
• 调用：使用 $SKILL_ROOT/scripts/update-skill.sh（或 .ps1），其中 $SKILL_ROOT/SKILL.md 是此技能文件——例如 ~/.cursor/skills/<name>、~/.codex/skills/<name>、~/.openclaw/skills/<name>、~/.agents/skills/<name>、~/.gemini/antigravity/skills/<name>；不要将 ~/.cursor（或任何不含 skills/<name>/SKILL.md 的宿主根目录）视为安装目录。只有一个参数时，脚本会按上述顺序解析 $SKILL_ROOT，然后才回退到脚本所在目录；工作区安装需要显式设置 DEST。双参数 check / apply / revoke-pending：规范顺序是先提供绝对路径 DEST（技能根目录），再提供 name；当只有一个规范化路径包含 SKILL.md 时，update-skill.sh / update-skill.ps1 会自动交换参数顺序（例如 Agent 先传 name，再传路径）。
• ClawHub 与完整目录树：未包含 update-skill.ps1 的安装，可以从 gate/gate-skills 的 skills/<name>/scripts/ 下手动复制该文件（仅限手动操作；Agent 不得自动下载）。

除调试外，不要将原始脚本日志直接输出到面向用户的回复中。严格模式下，若 check 的退出码为 3，在步骤 2 解决前不要执行。在符合运行时规则的情况下，若为 check_failed 或 apply 失败，仍应在适当时执行。

---

已知限制

• UGC 平台：Reddit、Discord 和 Telegram 依赖 search_ugc 是否可用。在该 API 上线之前，请将报告标注为仅涵盖 X/Twitter。
• 根据上游 API 覆盖情况，历史情绪趋势可能会退化为单点快照。

---

MCP 依赖项

仅适用于旧版路径——当步骤 0 输出 __FALLBACK__ 时，本节适用。

必需的 MCP 服务

MCP 服务	状态
Gate-News	✅ 必需

使用的 MCP 工具

查询操作（只读）

• news_feed_search_x（X/Twitter 讨论——例如，上游提供的 Grok 分析）
• news_feed_get_social_sentiment

身份验证

• 是否需要 API Key：否
• 凭据来源：无；此 Skill 仅使用只读的 Gate Info / Gate News MCP 访问权限。

安装检查

• 必需：Gate-News
• 安装：继续操作前，请使用当前主机 IDE 的本地 Gate MCP 安装流程。
• 只有在当前环境中可以使用所需的 Gate MCP 服务后，才能继续。

路由规则

仅限旧版路径——当 Step 0 输出 __ROUTE_CLI__ 时，路由将交由 gate-news-intel 处理。

用户意图	关键词	操作
社区对某种币的看法	"what does community think about ETH"	使用 coin 执行
X/Twitter 讨论	"Twitter discussion" "KOL views"	执行（聚焦 X）
总体社交情绪	"overall market sentiment"	执行（未指定具体币种）
Reddit/Discord 相关内容	"Reddit discussion"	告知：目前支持 X；UGC 即将推出
仅查看新闻	"any crypto news"	路由至 gate-news-briefing
币种分析	"analyze SOL"	路由至 gate-info-coinanalysis
价格变动原因	"why did BTC pump"	路由至 gate-news-eventexplain

---

执行工作流

仅限旧版路径——当 Step 0 输出 __FALLBACK__ 时，适用本节。

Step 0：多维度意图检查

• 社区/社交情绪 → 此 Skill。
• 同时分析币种基本面、技术面和宏观因素 → gate-info-research（如果可用）。

Step 1：意图识别与参数提取

• coin（可选）
• topic（可选）：例如 ETF、监管、Layer 2
• query：根据 coin + topic 构建 X 搜索词；如果两者都未指定，则进行总体市场社交扫描

Step 2：并行调用 MCP 工具

步骤	MCP 工具	参数	检索数据	并行
1a	news_feed_search_x	query={coin or topic}	X 讨论 / 观点脉络 / KOL 视角	是
1b	news_feed_get_social_sentiment	如果已指定，则为 coin={coin}	情绪评分、比例、提及量	是

Step 3：LLM 汇总

• 综合 X 上的定性讨论与定量情绪数据
• 总结主导观点脉络和 KOL 主题
• 分析情绪与价格的契合或背离情况

---

报告模板

仅限旧版路径——当 Step 0 输出 __FALLBACK__ 时，适用本节。

## Community Sentiment Scan: {coin or topic}

> Generated: {timestamp} | Platforms: X/Twitter only
> Note: Reddit/Discord/Telegram not yet supported.

### X/Twitter Discussion

{Summary from news_feed_search_x}

**Key Narratives**: ...
**Notable KOL Views**: ...

### Sentiment Metrics

| Metric | Value | Assessment |
|--------|-------|------------|
| Sentiment Score | {score} | {Bullish/Bearish/Neutral} |

### Sentiment vs Price

| Dimension | Current |
|-----------|---------|
| Social Sentiment | ... |
| Price Trend (24h) | ... |
| Alignment | {Aligned / Divergent} |

### Key Takeaways

{2–3 insights}

> Community sentiment is not a reliable price predictor. This does not constitute investment advice.

---

判断逻辑

条件	评估
情绪评分 > 70	强烈看涨——谨防反向风险
情绪评分 < 30	强烈看跌——可能出现投降式抛售或机会
正面比例 > 80%	强烈的正面共识——留意反转
讨论量 > 7 日均值的 2 倍	活动异常——可能存在催化因素
KOL 观点分歧	共识破裂——不确定性上升
情绪看涨但价格下跌	出现背离——情绪可能滞后
情绪看跌但价格上涨	出现背离——市场走势与预期相反

---

错误处理

错误类型	处理方式
news_feed_search_x 失败	仅提供情绪指标；注明无法获取 X 讨论
news_feed_get_social_sentiment 失败	仅提供 X 讨论；跳过指标
两个工具均失败	返回错误；建议重试
未找到与查询相关的 X 讨论	扩大查询范围；注明数据有限
用户询问 Reddit/Discord	说明目前无法提供 UGC；暂时仅支持 X

---

跨 Skill 路由

用户后续意图	路由至
"Analyze this coin"	gate-info-coinanalysis
"Any news about this?"	gate-news-briefing
"Why is it pumping/dumping?"	gate-news-eventexplain
"Technical analysis?"	gate-info-trendanalysis
"On-chain data?"	gate-info-tokenonchain
"How's the overall market?"	gate-info-marketoverview

---

安全规则

1. 不得捏造观点：仅报告有数据支持的内容；不得编造 KOL 引言。
2. 注明来源：除非数据中明确提及公众人物，否则统一归因于 KOL／社区。
3. 保持中立：同时呈现看涨和看跌观点。
4. 情绪 ≠ 预测：明确说明局限性。
5. 平台透明度：标明覆盖范围仅限 X/Twitter。
6. 错误信息：优先使用“流传的未经核实说法”，不要将传言当作事实陈述。
7. 年龄与资格：面向所在司法辖区内 年满 18 周岁且具有完全民事行为能力 的用户。
8. 数据流：宿主 Agent 处理用户提示词；此技能调用上文列出的 只读 Gate-News MCP 工具。大模型根据工具结果进行综合分析。此技能不会调用其他第三方数据服务。