新闻叙事挖掘器（News Narrative Miner）
为加密交易团队从新闻流中提取影响特定币种的事件、叙事阶段与衰减时点，并输出可量化的影响力评分。
该技能为只读新闻/叙事分析，未发现恶意行为、凭据窃取或隐蔽外传；SKILL.md 明确声明依赖 Nexus News API 并在禁用时回退到中性 stub，数据流向部分透明。扣分点：未说明外部请求的详细范围与频率、无用户确认/回滚机制、发布者身份未经验证，归因信息不全，无法给到高分。
仓库层面有 CI（ruff + pytest）和确定性 Nexus fixtures（含 news/news_analytics_sentiment 端点）以及上下文构建测试，happy path 可信。扣分点：未执行验证，本技能自身的失败反馈、边界输入处理、'neutral stub 回退' 行为细节未在技能文件中定义，无法高于静态上限 10。
场景清晰（加密新闻影响与叙事阶段分析），查询接口与输出契约（tier0/v1 JSON）明确。扣分点：能力边界和非适用范围未声明；核心数据源 Nexus News API 为海外服务且依赖外部注册/积分体系，对中国大陆网络可达性存疑，且无中文支持说明。
SKILL.md 简洁可读，persona.md 提供推理准则、输出契约和 few-shot 示例，仓库有 AGPL-3.0 许可证和结构化文档体系。扣分点：技能本身无版本号/变更记录/已知限制说明/FAQ，NexusDataClient 的安装与配置假设隐藏，维护责任未在技能层明确。
输出契约（impact score + event type + decay + reasoning）格式明确，在量化框架内边际价值可辨（自动衰减建模、黑天鹅分级）。扣分点：静态审阅无法验证输出可直接使用；few-shot 数值（Impact=88/45）为作者声称，无代表性输出样本或与手动分析的对比证据。
存在可审计的一手材料：CI 工作流、测试 fixtures 与 news 上下文单元测试支持部分声明。扣分点：无第三方执行证据，技能级关键路径（分数公式、decay 模型、黑天鹅触发）未见独立可复现测试覆盖，事实与推断边界未标注，低于静态上限 5。
- 核心数据依赖海外 Nexus News API，中国大陆网络可达性未验证，使用前请确认网络与配额（Nexus 积分在 BNB Chain 结算）。
- 未实际执行验证：影响分数、衰减模型与黑天鹅触发的正确性均为静态推断，请勿直接用于真实交易决策。
- 发布者身份未经 FollowSkills 注册表验证，技能本身缺少版本与变更记录，升级时需自行核对行为变化。
- Nexus 禁用时回退为中性 stub，可能静默返回无信息结果，建议在下游逻辑中显式检测回退状态。
这个 Skill 能做什么，适合哪些场景？
新闻叙事挖掘器是 olaxbt/ai-market-maker（AIMM，开源的 Agentic AI 对冲基金操作系统）单体仓库中 14 个 OpenClaw 技能之一，位于 src/agents/operator/1.2_news_narrative_miner/。它面向单个交易品种（如 BTC/USDT），通过 Nexus News API 获取新闻数据，分析突发事件对该品种的影响，识别当前叙事所处的阶段，并维护一个内存中的新闻衰减时间线。查询通过 /news_narrative_miner?ticker=BTC/USDT 接口完成，返回影响力评分、事件类型、衰减信息和推理说明。当 Nexus 被禁用时，它会回退到中性占位结果而不是报错。整个仓库以 AGPL-3.0 许可发布，Python 3.11+ 环境下通过 uv 管理依赖。
读取指定交易品种的新闻数据（经 Nexus News API，由 NexusDataClient 客户端调用）；分析突发事件（如“有没有影响 BTC 的突发新闻？”）并给出影响评分、事件类型；判断当前叙事阶段（如“当前叙事处于哪个阶段？”）；维护内存中的新闻衰减时间线，追踪事件影响力的时间衰减；以 Tier-0 契约暴露 analyze(ticker, market_data, nexus_context) 接口，并通过 /news_narrative_miner?ticker=BTC/USDT 查询接口返回评分、事件类型、衰减与推理。当 Nexus 被禁用（NEXUS_DISABLE）时返回中性占位数据，保证流水线不断裂。
- 加密对冲基金的研究员在持仓期间想快速确认是否有突发新闻会冲击某个币种（如 BTC），需要带评分和理由的简明答案
- 量化交易团队的叙事交易策略需要程序化地判断某币种当前处于叙事周期的哪个阶段，以便决定入场或退出时机
- AIMM 多智能体流水线的运营者（operator）需要一个上游新闻信号节点，为后续的 Alpha 合成和风控提供叙事输入
- 在本地回测或演示环境中（Nexus 未启用、无外网）需要新闻节点优雅降级、返回中性结果而不阻塞整个工作流的开发者
- 希望在部署 AI 交易栈前先独立评估某个技能模块的工程师，可单独查看该 SKILL.md 了解其数据依赖与接口契约
这个 Skill 有哪些优点和局限？
- 接口契约明确：Tier-0 的 analyze 签名和查询接口的返回字段（影响评分、事件类型、衰减、推理）都有文档
- 优雅降级：Nexus 不可用时回退到中性占位数据，不会让整条流水线崩溃
- 内建新闻衰减时间线，追踪事件影响力的时效性，而非只做静态打分
- 所属项目遵循统一标准化接口、可全链路追踪，且整体在 AGPL-3.0 下开源可审计
- 数据来源单一，依赖 Nexus News API；没有 Nexus 凭证时只能得到占位结果，无法进行真实的新闻分析
- SKILL.md 未说明影响评分的计算方法、新闻源覆盖范围或衰减模型，难以独立评估输出质量
- 缺少该技能单独的测试或基准证据；仓库层面的回测示例数字来自整体系统，不能归因于此技能
- 接口主要面向 AIMM 流水线内部（ticker 格式如 BTC/USDT、Nexus 上下文），独立复用需要自行适配
如何安装这个 Skill？
该技能随整个仓库分发：git clone https://github.com/olaxbt/ai-market-maker.git 并 cd ai-market-maker；安装 uv（pip install uv）；uv sync --extra dev 安装依赖（完整平台栈需 TA-Lib 与 Docker，见仓库 Quick Start，但单独运行此技能所需的最小依赖未在文档中说明）；如需通过 OpenClaw 安装，可使用 claw install https://github.com/olaxbt/ai-market-maker。技能文件位于 src/agents/operator/1.2_news_narrative_miner/SKILL.md。注意：源材料没有说明如何将此单体仓库中的单个技能文件夹独立安装到任意 Agent Skills 客户端，也未给出该技能专属的环境变量。
如何使用这个 Skill？
直接用自然语言查询，例如：“Any breaking news impacting BTC?”（有没有影响 BTC 的突发新闻？）或“What's the current narrative phase?”（当前叙事处于哪个阶段？）。程序化调用则请求查询接口 /news_narrative_miner?ticker=BTC/USDT，返回影响力评分、事件类型、衰减信息与推理说明。也可在代码中以 analyze(ticker, market_data, nexus_context) 的 Tier-0 契约调用。需在 .env 中配置 Nexus Skills API 访问（可选）；若未配置或设置了 NEXUS_DISABLE=1，技能会返回中性占位结果。仓库整体运行推荐 docker compose -f docker-compose.prod.yml up --build -d 并访问 http://localhost:3000。
这个 Skill 与同类方案有什么区别？
在 AIMM 自身的架构中，该技能对应 README 所列“Sentiment & Narrative”研究台中的叙事部分，与市场扫描、技术分析、统计 Alpha 等其他研究台节点互补；源材料未提及外部竞品，故不作外部对比。