community-signal-digest

Community Signal Digest 是一个社区信号监测技能，用于在开发者社区中追踪品牌提及、竞品信号和话题相关讨论。它输出按优先级排序的可执行摘要，附带互动角度和自动起草的回应。

【用途】 监测开发者社区中的品牌提及、竞品动态和话题讨论，发现互动机会，支持每日社区扫描或每周社区回顾。

【数据来源】 主要数据源为 search_external_content，查询 DEV.to、Hacker News、YouTube 和 Hashnode。无需付费席位或账号（YouTube 支持取决于服务端 API key 配置）。可选增强为 Common Room，可补充 Reddit、Stack Overflow、X、Slack、Discord、Discourse 覆盖及联系人数据（线索评分、公司、分群）。若 Common Room 已连接，结果会合并并去重。

【使用场景】

• “运行我的每日社区扫描”或“社区摘要”
• “开发者们怎么评价我们？”
• “查看社区提及”或“品牌监测”
• “寻找互动机会”
• “运行每周社区回顾”
• 任何涉及社交聆听、社区信号或品牌提及的场景

【运行模式】

• 每日扫描：非周一工作日的默认模式。时间范围为最近 24 小时，输出 3-8 条可执行项，零摩擦：一条命令，立即输出。
• 每周回顾：周一默认模式，或用户说“weekly”时。时间范围为最近 7 天，输出 15-40 条，含趋势分析和“此前标记”板块，用于展示之前运行中未处理的陈旧项。 若用户只说“社区摘要”而未指定，则在非周一工作日使用每日模式，周一使用每周模式。

【工作流程】

1. 预检：读取 REFERENCES.md 并运行预检，调用 list_marketing_references() 验证 Tiger Den 可达性；若失败或工具未找到则停止。确认后获取 product-marketing-context 和 brand-voice-guide 参考文档。
2. 检测可用数据源：探测外部内容搜索（search_external_content 连通性测试）和 Common Room（commonroom_list_objects），设置布尔标志，报告检测结果。若两者均不可用则停止并提示运行 /doctor 或检查 Common Room MCP 配置。
3. 预过滤：读取 intel-records-integration.md，生成 source_run_id 和 source_run_at，按模式确定陈旧阈值（每日 3 天，每周 10 天），计算 scan_lookback_start（每日 24 小时前，每周 7 天前），查询最近记录（去重）和查询陈旧记录（重新浮现候选），合并为已知信号映射。
4. 构建关键词集：search_external_content 在服务端解析关键词预设（brand、competitors、topics），展开为 HN/YouTube 的关键词搜索词和 DEV.to/Hashnode 的平台原生标签 slug。Common Room 查询直接使用品牌关键词列表。自定义关键词通过 keywords 参数（仅 HN/YouTube）和/或 tags 参数（仅 DEV.to/Hashnode）传递；显式关键词不会到达 DEV.to 或 Hashnode。
5. 采集输入：每日扫描跳过问答使用默认值；否则通过对话式问答收集时间范围、模式、源过滤、平台过滤、优先级过滤。
6. 外部内容搜索：分品牌提及、话题与竞品信号、平台特定运行。结果预归一化（标题、URL、作者、日期、摘要、标签、互动分数、平台），跨平台 URL 去重由服务端处理，检查 platformStatus 报告被跳过平台。
7. Common Room 查询（可选）：品牌提及、话题信号、负面情绪兜底（品牌关键词 + 负面情绪标签 l_683607），按 activity id 去重。
8. 去重合并：跨源按源 URL 匹配（归一化：去尾斜杠、查询参数、www. 前缀、转 https://），保留 CR 版本并标记 source_type: "both"。Intel records 去重按 content hash 查找，处理已处理/新近/陈旧匹配。
9. 噪音过滤：过滤自身账号活动、无评论转发、通用列表提及、GitHub 仓库星标、话题/竞品查询中互动分数为 0 的项、自有出版物 Hashnode 文章。报告过滤统计。
10. 信号增强（可选）：CR 联系人数据、Stack Overflow 浏览量（WebFetch）、外部内容作者档案（最多 3 次获取）。
11. 分类与优先级：双路径——CR 项使用活动类别标签，外部内容项使用关键词启发式。计算优先级分数（urgency_weight + thread_momentum + author_fit + recency_bonus + response_window），每日取前 3，每周取前 5-10。
12. 后验证并写入 intel records：跨技能去重（find_duplicates），无匹配则创建 community_signal 记录。

【限制】

• YouTube 支持取决于服务端 API key 配置。
• 显式关键词不会到达 DEV.to 或 Hashnode，这些平台仅支持基于标签的过滤；无法识别的标签会被静默忽略。
• Common Room 为可选，未连接时部分平台（Reddit、Stack Overflow、X、Slack、Discord、Discourse）及联系人数据不可用。
• 若外部搜索与 Common Room 均不可用则停止。
• 超时时可减少平台或降低 max_results_per_platform 重试。
• 若 manage_intel_records 不可用或查询失败，则跳过去重并在摘要页脚报告。