用途
mention-radar 用于监测外部网络和社交媒体上关于运营者活跃项目的提及，帮助发现人们在哪里发现项目、在哪里感到困惑，以及哪些地方值得互动。其核心定位是信号过滤，而非指标报告——一次真实对话比十次曝光更有价值。
主要能力
确定跟踪目标： 如果提供了逗号分隔的项目名变量则解析该变量；否则扫描 memory/MEMORY.md 和 memory/topics/projects.md 来推导运营者的活跃项目。每个目标至少需要名称，已知时还会收集站点/域名和 GitHub owner/repo。最多限制 6 个目标，优先选择最活跃的。若无法推导出任何目标，则记录 MENTION_RADAR_SKIP 并停止，不发送通知。
构建搜索词： 对每个目标构建精确项目名引号搜索、域名搜索、仓库搜索。
搜索外部提及： X/Twitter 通过 X.AI Responses API（首选）；其余公开网络（Reddit、Farcaster、博客、newsletter、GitHub Discussions、HN、Product Hunt）通过 WebSearch。可从 soul/SOUL.md 推导运营者 handle 以排除其自己的帖子。
GitHub 网络信号： 对已知仓库使用 gh api 检查 stars、forks、watchers，并与上次日志条目比较计算增量；无先前数据则记录为基线。
分类提及： 将找到的提及分为发现（首次发现并分享）、困惑（不清楚项目做什么、提问、误解）、摩擦（遇到设置/文档/缺失功能问题）、竞品对比、功能请求/愿望、媒体/newsletter 引用。
识别互动机会： 标记困惑且一条推文澄清会有帮助的提及、与正在构建内容一致的功能请求、错误或不完整的竞品对比、高关注者账号发现项目的高杠杆回复机会。
使用方式
技能接收逗号分隔的项目名变量（例如 "MyApp, my-lib"）。若为空，则从 MEMORY.md 和 memory/topics/projects.md 推导目标。
Path A — X.AI API（首选，X/Twitter 提及）： 对每个目标询问 Grok 的 x_search 谁在 X 上谈论该项目。使用 secretcurl 向 https://api.x.ai/v1/responses 发送 POST 请求，设置 Bash 工具超时至少 180000，curl 的 --max-time 为 150，捕获 HTTP 状态。使用 jq 构建 payload 到固定文件 /tmp/xai-mr-payload.json，再用 -d @file 发送。HTTP=200 且正文非空时解析 /tmp/xai-mr.json，记录 X_SOURCE=api。
Path B — WebSearch（更广网络 + X 回退）： 始终用于非 X 渠道。尝试品牌名和 URL 变体，时间限制在最近 7 天，跳过运营者自己账号和项目自己仓库的结果。X 回退仅在 Path A 真正失败时使用（key-unset、http-<code>、empty、timeout），并记录真实原因，设置 X_SOURCE=websearch。
GitHub 信号： 对已知仓库运行 gh api repos/OWNER/REPO --jq '{stars: .stargazers_count, forks: .forks_count, watchers: .watchers_count}'，404 的仓库跳过。
输出格式（4000 字符以内）： 包含 Mention Radar 标题和日期，每个目标一个区块列出 [来源] — [他们说了什么] — [类别]，然后是互动机会区块，以及对无提及项目使用 QUIET 标记。少于 5 的 GitHub 星标增量跳过，只提及显著跳跃。
通知与日志： 仅在有信号时通过 ./notify 发送。若所有项目都安静且无 GitHub 星标增量大于 5，则跳过通知并记录 MENTION_RADAR_QUIET。记录到 memory/logs/${today}.md，包含每个目标的提及数/安静状态、最佳发现、标记的互动机会数、是否发送通知。
适用场景
适合需要持续了解外部社区对自身活跃项目反应的运营者，尤其是希望抓住早期发现者、解答困惑、回应真实摩擦、纠正错误竞品对比、追踪功能请求对齐情况，并识别高杠杆回复机会的场景。
限制
需配置 XAI_API_KEY 用于 X/Twitter 提及；若未设置，X 提及降级为质量较低的 WebSearch 回退，但不影响更广网络搜索。需要预先认证的 gh CLI 用于 GitHub 信号检查。X.AI x_search 调用通常需要 30–120 秒。报告上限 4000 字符。最多跟踪 6 个目标。仅基于找到的信号触发通知，不制造紧迫感。
环境变量
XAI_API_KEY — 用于 Grok x_search 的 X.AI API 密钥，在 requires 中声明为可选，注入到技能环境，是 X/Twitter 提及的首选路径。若未设置，X 提及降级为 WebSearch 回退。
gh CLI — 在 GitHub Actions 中预先认证，用于 GitHub 网络信号检查。