hike-earnings-core
财报核心指标结构化提取器,通过 /hike-earnings-core 显式调用。
How do I install this agent skill?
npx skills add https://q.hikecapital.com --skill hike-earnings-coreIs 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。核心原则对两个市场一致:
- 权威优先:公司原始公告(美股 IR 新闻稿 / 8-K exhibit,港股披露易业绩公告)> 上市地监管存档(SEC EDGAR XBRL / HKEXnews 披露易)> 财经媒体。媒体数据只能做交叉校验,不得作为主来源单独成文。
- 时效性:财报刚发布时监管存档(EDGAR/披露易)可能尚未入库,此时直接抓公司 IR/newsroom 的原始新闻稿,不要等。
- 财年错位:很多公司财年不等于自然年,同一报告期在两种口径下可能相差一季以上。输出时两个都要标:公司自己的财报期 + 对应自然季度,别混(实例见
references/sources-us.md常见坑)。 - 找不到的字段填
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推算项,提醒用户注意。
How can the creator link this skill?
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>