关于 hertzflow
hertzflow 是面向链上与中心化交易所交易研究的 Agent 技能，会按请求路由到领域指令。已提供的 alpha 工作流将确定性数据处理与 LLM 叙述填充分离，并依据证据和锁定输出校验写入。
主要功能
- 01按意图路由研究领域
- 02分析 Alpha 地址与代币
- 03确定性取证流水线
- 04限制 LLM 叙述字段
- 05校验证据与输出
适用场景
- 01调查 EVM 合约地址
- 02检查 Solana 代币地址
- 03解析 Binance Alpha 代币代码
- 04分析代币分布或筹码结构
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/hertzflow确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
alpha/INSTRUCTIONS.mdalpha/data/cex_hot_list.txtpassive_mm_brands.txtalpha/v06/forensic_pipeline.pyalpha/v06/examples/fartcoin_v0_7_21_8_holder_snapshot_skeleton.jsonjellyjelly_v0_7_21_8_holder_snapshot_skeleton.jsonalpha/v06/helpers/_version.pyaddress_role_resolver.pybehavior_classifier.pybscscan_label_probe.pychain_router.pycross_sym_detector.pycross_sym_registry.pydump_tracker.pyevidence_graph.pyfake_mining_detector.pyflow_operator_detector.pyfunding_source_attribution.pyhidden_operator_activity.pyhidden_operator_enricher.pyi18n.pyidentity_classifier.pymonitoring_export.pymonitoring_ranker.pyparallel_surf.pypre_launch_insider_index.pyprimary_sale_attribution.pyprotocol_lockup_detector.pypush_airdrop_detector.pyrecent_flow_actions.py详细介绍
hertzflow — 加密交易决策智能（单一技能，多领域）
hertzflow 是 HertzFlow 面向链上和 CEX 交易研究的总括技能。与 Surf 一样，它是一个带有内部路由的技能——请阅读下表，了解哪个子领域负责处理用户请求，然后遵循该子领域的 INSTRUCTIONS.md。
🌐 语言 — 必须遵循，请先阅读
检测用户最近一条消息的语言，并在所有内容中使用该语言：包括对话回复和生成的报告。 这是强制要求，不是可选项，也不需要用户提出要求。
- 消息包含 CJK 字符（
一-鿿、假名、韩文）→ 使用中文（zh）：用中文回复，并通过--lang zh运行流水线。 - 否则（英文／拉丁字母提示）→ 使用英文（
en）：用英文回复，并通过--lang en运行流水线。
支持的报告语言为 zh 和 en（静态、人工整理的语言包）。对于使用其他语言的提示，请用该语言回复，但使用 en 生成报告（最接近的受支持语言），并用一行说明。
报告正文的语言在流水线运行时通过 forensic_pipeline.py --lang {zh|en} 锁定——渲染时无法更改，叙述性填充内容也必须使用相同语言。具体规则见 alpha/INSTRUCTIONS.md 的“Report language”部分。若设置错误，则必须完整重新运行流水线（会再次消耗 Surf 额度），因此要从一开始就根据用户使用的语言进行设置。
路由表
| 如果用户输入符合…… | 子领域 | 指令文件 |
|---|---|---|
原始的、带 0x 前缀的 40 位十六进制 EVM CA（0xea37a8de…） | alpha（Binance Alpha 取证） | alpha/INSTRUCTIONS.md |
Solana base58 CA（例如 Grass7B4R…） | alpha（HOLDER_SNAPSHOT 模式） | alpha/INSTRUCTIONS.md |
当前在 Binance Alpha 上的代币代码（$JCT、$VELVET 等） | alpha — 先通过 surf search-token --q <ticker> 将代币代码解析为 CA，然后再分派 | alpha/INSTRUCTIONS.md |
| 关于 Alpha 分布／内幕出货／链上派发／quiet insider／筹码结构的自然语言表述 | alpha | alpha/INSTRUCTIONS.md |
永续合约交易对（例如 BTCUSDT）＋分析意图 | perp（尚未推出） | — 即将推出 |
| 桥接协议名称＋审计意图 | bridge（尚未推出） | — 即将推出 |
| HertzFlow 自身的合约地址＋诊断意图 | core（尚未推出） | — 即将推出 |
调用后的首要操作
- 根据上面的路由表识别子领域（默认：
alpha）。 - 执行
cat <sub-domain>/INSTRUCTIONS.md（路径相对于此技能的安装根目录——运行时为~/.claude/skills/hertzflow/或同等的 Agent 技能目录，而非仓库根目录。因此，对于 alpha 子领域，请读取alpha/INSTRUCTIONS.md。）也可以通过 Agent 的文件读取工具读取该文件。该文件是完整的、针对各领域的 SKILL.md，包含入门指南（Surf CLI 安装＋API 密钥提示）、前置条件、3 步工作流（forensic_pipeline.py→ LLM 填充 →render_report.py）、可写槽位指南、验证器规则和输出架构。 - 逐字遵循该文件中的指令。不要根据此路由文件重新推导工作流——各领域的指令是权威内容，并且版本已锁定。
此技能采用这种结构的原因
- 单一斜杠命令
/hertzflow：HertzFlow 是一个涵盖多个研究领域（Alpha 取证、永续合约指标、桥接审计、HertzFlow 核心）的统一产品品牌。用户只需调用一个斜杠命令，由路由器负责分派。 - 宽泛的描述触发范围：上面的描述告诉 Agent，应在自然语言提及内幕派发、筹码结构等内容时自动触发——和 Surf 一样，用户无需明确输入斜杠命令。
- 子领域隔离：每个子领域都位于各自的文件夹中，并拥有独立的
INSTRUCTIONS.md、辅助工具和版本跟踪。日后添加perp/无需修改alpha/代码。
信任边界（适用于每个子领域）
- Pipeline（Python）。 确定性执行。负责所有 SQL、链上读取和证据图 ID。唯一接触数据的层。
- LLM（任意模型）。 在结构化的可写字段中填写叙述内容。不能编写 SQL。不能选择判定结果。不能决定阈值。
- 验证器。 拒绝 LLM 在可写字段之外的写入、对证据图中不存在的数据的引用、重复的模板内容，以及任何覆盖锁定的 Pipeline 输出的尝试。
每个子领域的 INSTRUCTIONS.md 都必须遵守这三条边界。
升级
npx skills update hertzflow
这会从 HertzFlow/hertzflow-skills 的 main 分支拉取最新版本。
在重要版本发布后运行（v0.9.x → v1.0.0 等）。当前版本位于 frontmatter（metadata.version）和 alpha/v06/helpers/_version.py 中。