skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
q.hikecapital.com86 installs

hike-earnings-core

财报核心指标结构化提取器,通过 /hike-earnings-core 显式调用。

How do I install this agent skill?

npx skills add https://q.hikecapital.com --skill hike-earnings-core
view source ↗

Is this agent skill safe to install?

No partner audit is available yet. Read the source before installing.

What does this agent skill do?

财报核心指标结构化提取(hike-earnings-core)

定位与边界

本 skill 做一件事:把一份财报(无论来自网络还是用户手里)变成一份结构化、可入库、可直接对比的 JSON 文档。

明确不做的事,遇到时告知用户由其他流程承接,不要顺手做:

  • 股价数据:不做 K 线/走势/财报反应涨跌幅
  • 媒体报道与解读:不搜集公众号/媒体观点
  • 投资建议:不做判断,只忠实转译财报

为什么这样切分:财报发布后的信息是分批到位的——核心指标在发布当时即可从官方渠道获取,媒体报道要 24 小时内才沉淀,股价走势要等一两天才有意义。本 skill 只负责最快、最可靠的第一层。上层应用(如周报生成器)会把本 skill 的输出与股价、媒体解读合并。

输入路由

按用户输入判断走哪条路径,两种输入可以同时存在(如"这是它的上季度财报 PDF,再帮我拉最新一季对比"):

输入路径
股票代码 / 上市公司名Route A:网络获取(美股见 references/sources-us.md,港股见 references/sources-hk.md)
用户提供的财报文件(PDF/图片/文本,含非上市、机密)Route B:本地提取(见下)

多只股票 = 多个独立输出文档,逐只处理,一家的失败不影响其他家。

开始提取前,先读 references/schema.md——输出 schema 的字段定义、basis 枚举、note 约定都在那里,不要凭记忆即兴发挥。

Route A:公开股票(美股/港股)

按上市地选获取路径:美股见 references/sources-us.md,港股见 references/sources-hk.md。核心原则对两个市场一致:

  1. 权威优先:公司原始公告(美股 IR 新闻稿 / 8-K exhibit,港股披露易业绩公告)> 上市地监管存档(SEC EDGAR XBRL / HKEXnews 披露易)> 财经媒体。媒体数据只能做交叉校验,不得作为主来源单独成文。
  2. 时效性:财报刚发布时监管存档(EDGAR/披露易)可能尚未入库,此时直接抓公司 IR/newsroom 的原始新闻稿,不要等。
  3. 财年错位:很多公司财年不等于自然年,同一报告期在两种口径下可能相差一季以上。输出时两个都要标:公司自己的财报期 + 对应自然季度,别混(实例见 references/sources-us.md 常见坑)。
  4. 找不到的字段填 null,绝不编造、不"估计一个差不多"。

Route B:用户提供的材料(含机密)

红线:用户提供的材料一律本地处理。 只用本地工具(Read、pdftotext、python 提取等)读取和分析,不把材料内容发给任何外部网络服务(firecrawl、搜索引擎、在线 OCR 等)。联网路径只服务于 Route A 的公开代码输入。这条约束的原因是用户的材料可能是非上市公司机密,外发即泄密。

处理要点:

  • PDF/图片材料:在本地完成文本提取,手段(命令行工具、Python 解析库、其他本地办法)由你当场根据环境自行决定,能拿到完整文本即可。硬要求是表格数字与原文零失真——整页转图或低精度转换容易丢表格精度,部分环境也不支持把文档直接喂给模型;走哪条路踩到这两个坑就换手段,别硬走。
  • 扫描版/图片型 PDF:本地工具提取不到文本层时,告知用户原因,问是否授权使用外部 OCR——未经同意不外发。
  • 非上市公司没有"共识预期",vsConsensus/vsGuidance 自然为 null,这是正常现象不是缺陷。
  • 材料口径可能是 IFRS 或中国企业会计准则,甚至是内部管理口径——如实写进 basis,不要强行换算成 GAAP。

提取规则

指标的组织方式、字段语义、basis/note 的分工见 references/schema.md,几条容易犯错的:

  • 每个指标是一个统一信封:{value, yoy, qoq, vsConsensus, vsGuidance, basis, note}。数值比较关系(增速、超/低共识、落在指引区间哪个位置)一律进结构化字段,note 只放影响理解的叙述(一次性损益、口径变更原因等),用最简短语、≤40 字,不写句子、公式或数值复述;服务端不解析 note。
  • 毛利与营业利润:披露什么填什么,两个都披露就都填;都只披露一个时另一个为 null。
  • 比率允许由披露值直接计算:毛利率 = 毛利/收入、净利率 = 净利/收入这类「准则定义内的算术」不算推算——basis 沿用分子的口径(如 GAAP),不需要在 note 说明计算方式。只有当计算依赖口径假设(如把 Non-GAAP 项目从 GAAP 里剔除、跨境税负分摊估计)时才算推算,此时 basis 标 Estimated 并在该指标的 note 里说明推算方法。
  • 比率的同比/环比放 yoy/qoq:毛利率、营业利润率、净利率这类 ratio 指标,yoy/qoq 记百分点变化(0.012 = +1.2pp,-0.0273 = -2.73pp),不是相对增速;vsConsensus.delta 同样按百分点差(value − consensus),不要把这些数据写进 note。
  • 管理层评论(managementCommentary):采集管理层对当期经营的定性说明,逐条记为 {speaker, theme, statement}。它与 guidance 的分工:guidance 是公司对未来财务表现的有数字指引,commentary 是当期解释;capex、利润率目标等前瞻财务数字归 guidance.keyPoints,回购/股息等资本回报不算业绩指引、不要搬进来。宁缺毋滥:最多 3 条,只收对理解本期业绩最关键的(核心业绩驱动、重大一次性项目),一般性的战略表态和客套话不收;新闻稿 CEO 引语段、业绩说明会的定性内容是来源;材料里确无此类内容时为空数组。
  • 业绩指引(guidance):只收公司自己的前瞻财务指引且必须带数字,只保留「指标 + 区间/目标 + 口径」,不写背景和原因;nextQuarter/fullYear 各一句话(≤80 字),其余前瞻财务指引放 keyPoints(最多 3 条、每条 ≤60 字)。回购/股息、战略愿景、无数字的定性预期、历史数据、第三方预测都不收。
  • vsGuidance 跨期对照:对照公司自身指引时,若本期新闻稿未附指引区间,取上一季新闻稿中披露的本期指引进行对照,note 写明取自哪一期发布。口径必须一致——调整后(Non-GAAP)指引只能对照调整后实际值;口径不同(如 GAAP 实际 vs Non-GAAP 指引)时不要硬填 vsGuidance,把差异关系写进 note。
  • 净利:注意"归属母公司股东"与"含少数股东损益"的差异,用 note 标清。
  • EPS:basic/diluted/non-GAAP 能取到几个填几个。
  • 分业务(segments):收入口径的分部数据;分部利润没有单独字段,放该分部的 note。
  • 非标 KPI(highlights):只收不在固定指标内、且非其派生比率的运营指标(TCV/backlog/GMV/ARR/客户数等),按 {name, value, unit, unitLabel, yoy, qoq, basis, note} 记录,最多 6 条;标准财务科目、股息/回购、管理层表态都不放这里(capex/利润率目标等前瞻财务数字进 guidance.keyPoints,定性说明进 managementCommentary)。
  • 币种与单位:原币种计量,currency + monetaryUnit 写清楚(如 USD + M = 百万美元)。多文档之间不做汇率换算,留给上层。

输出与校验

  • 逐只独立文档,命名 earnings_<TICKER或公司名>_<period>.json(period 用公司财期,如 EXMP_FY26Q3.json、某科技公司_2026Q2.json),默认存到 ./earnings/,用户指定了位置就听用户的。
  • 写完跑一遍校验:JSON 合法;所有指标对象字段齐全(缺失项为 null 而不是缺键);yoy/qoq 若非 null,与本期/上期值方向自洽。
  • 向用户汇报时给出文件路径 + 一句话摘要(收入/净利 + 同比 + 数据来源),不要把整个 JSON 贴出来;若存在 Estimated 推算项,提醒用户注意。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/q.hikecapital.com/hike-earnings-core">View hike-earnings-core on skillZs</a>