unlock-monitor

用途

unlock-monitor 用于追踪代币解锁与归属（vesting）事件，量化其可能带来的供给压力，并输出可操作的市场解读。它的核心主张是：按“占流通供应量百分比”排序是弱代理指标，真正有效的指标是吸收比率（Absorption Ratio），即解锁美元价值除以 7 日平均日交易量。资料引用 Keyrock 对 16k+ 次解锁的分析称，比率高于约 2.4× 会持续挤压流动性并产生可测量的价格回撤，低于约 0.5× 则市场通常无感。

主要能力

• 以吸收比率为主排序，供应百分比为辅，并纳入 cliff 与 linear 结构以及解锁前价格走势，形成逐事件判断。
• 将事件分级：CRISIS（> 2.4×）、STRAIN（1.0×–2.4×）、DIGESTIBLE（0.3×–1.0×）、TRIVIAL（< 0.3×）。
• 接收方覆盖：团队或投资者解锁在比 CRISIS 低一档时上调一档；社区或质押奖励解锁在比率高一档时下调一档。法院强制分配（FTX、Mt. Gox、Celsius）绕过分级系统，始终纳入并标注 forced，注明法律时间线。
• 生成一句话市场解读：priced in（30 天跌超 20% 且比率 ≤ STRAIN）、market asleep（30 天持平或上涨且为 STRAIN 或 CRISIS）、fade pump（30 天涨超 15% 且为 CRISIS）、forced sellers（法院强制）、absorbable（TRIVIAL 或 DIGESTIBLE 且无接收方标记）。
• 对 cliff 解锁提示模式：弱势通常提前约 30 天开始，交易量在解锁日达到峰值，10–14 天后恢复。
• 按吸收比率降序、接收方标记、美元价值排序，取前 8 个（除非法院命令或接收方标记提升，否则丢弃 TRIVIAL）。
• 通过 ./notify 推送不超过 4000 字符的摘要，包含标题事件、分级分组与供给解读。
• 将已推送事件键（${ticker}:${unlock_date}）写入 memory/state/unlock-monitor-seen.json，并保留最近 90 天；同时记录日志到 memory/logs/${today}.md。
• 若结果列表为空，输出 UNLOCK_MONITOR_QUIET 并附一句说明。

使用方式

技能按步骤执行：

1. 读取 memory/MEMORY.md 获取市场仓位与活跃叙事上下文；读取最近 7 天 memory/logs/ 去重；读取 memory/state/unlock-monitor-seen.json（若存在）跳过已推送的精确匹配项。
2. 并行执行多条 WebSearch，覆盖 tokenomist.ai、defillama.com、cryptorank、dropstab、FTX/Mt. Gox/Celsius 债权人分配以及按美元价值角度的解锁查询；同时 WebFetch 以下来源（失败时用 WebFetch 回退）：https://tokenomist.ai、https://defillama.com/unlocks、https://cryptorank.io/token-unlock、https://dropstab.com/vesting、https://www.coingecko.com/en/highlights/incoming-token-unlocks。记录哪些来源返回数据，并在日志中输出 sources 行。
3. 对每个候选事件，从 CoinGecko 搜索结果或 https://www.coingecko.com/en/coins/${slug} 获取 7 日平均日交易量（美元）、抓取时现货价格、30 天价格变化百分比、归属结构（cliff/linear/mixed）与接收方类别（团队、投资者、生态、社区、债权人）。若交易量不可用，标记 vol=unknown 并保守分级，不跳过但在输出中标注缺口。
4. 计算 absorption_ratio = unlock_usd_value / avg_daily_volume_usd_7d，并按上表分级，应用接收方覆盖规则。
5. 按吸收比率降序、接收方标记、美元价值排序，取前 8，去重后若为空则输出 UNLOCK_MONITOR_QUIET。
6. 通过 ./notify 发送摘要，格式为标题事件、CRISIS/STRAIN/DIGESTIBLE/FORCED 分组、供给解读与 sources 状态行。
7. 持久化状态并写日志，状态可为 UNLOCK_MONITOR_OK、UNLOCK_MONITOR_QUIET、UNLOCK_MONITOR_DEGRADED（2 个以上来源失败）或 UNLOCK_MONITOR_ERROR（全部失败）。

环境变量：无需任何环境变量，仅使用 WebSearch 与 WebFetch。通知渠道通过仓库 secrets 配置（见 CLAUDE.md）。网络方面，curl 可用，无网络沙箱；WebFetch 作为不稳定公开 GET 的回退，所有数据源均为公开、无需认证。

适用场景

适合需要跟踪代币供给端压力、判断解锁事件是否已被市场定价、识别 cliff 与 linear 解锁不同风险特征的用户或自动化流程。可用于每周供给面简报，也可在活跃叙事背景下评估解锁影响（叙事消退时解锁冲击更大，叙事火热时解锁易被吸收）。

限制

• 依赖公开数据源可用性；若 2 个以上来源失败标记 DEGRADED，全部失败标记 ERROR。
• 交易量数据缺失时只能保守分级并标注缺口。
• 吸收比率阈值、cliff 时间模式等来自资料所述分析，并非对所有市场状况的保证。
• 法院强制分配无战略裁量，按法律时间线单独处理，不适用常规分级。
• 输出长度限制为 4000 字符以内。