用 Claude Custom Skill 构建财务报表比率分析器:从 SKILL.md 到可落地的财务分析引擎

发布时间:2026/9/8 17:54:22

用 Claude Custom Skill 构建财务报表比率分析器:从 SKILL.md 到可落地的财务分析引擎 用 Claude Custom Skill 构建财务报表比率分析器从 SKILL.md 到可落地的财务分析引擎【免费下载链接】claude-cookbooksA collection of notebooks/recipes showcasing some fun and effective ways of using Claude.项目地址: https://gitcode.com/GitHub_Trending/an/claude-cookbooksClaude Skills 允许开发者以目录 SKILL.md 可执行脚本的形式把特定领域的专业知识打包成可被 Claude 动态加载的能力。本篇文章以 claude-cookbooks 仓库中的 analyzing-financial-statements 自定义技能为完整范本讲解如何设计一份财务比率计算技能——包括六大类财务比率的指标体系、输入输出约定、两条核心 Python 脚本的计算原理以及如何在 Jupyter Notebook 中把它上传、测试并用于实际投资分析。读完本文你将掌握自定义财务分析类 Skill 从目录结构、Frontmatter 编写到代码实现的完整方法论。技能目录与 FrontmatterSkill 的身份证Custom Skill 的目录结构遵循统一约定SKILL.md是唯一必需文件其余脚本、资源均为可选。analyzing-financial-statements 目录下共包含三个文件skills/custom_skills/analyzing-financial-statements/ ├── SKILL.md # 技能说明必需Frontmatter 指令正文 ├── calculate_ratios.py # 计算引擎全部财务比率的计算实现 └── interpret_ratios.py # 解释模块行业基准对比、趋势分析与报告生成SKILL.md开头是 YAML Frontmatter定义了 Claude 在**加载阶段Metadata Stage**最先看到的两项信息它们决定了技能何时被检索、被调用--- name: analyzing-financial-statements description: This skill calculates key financial ratios and metrics from financial statement data for investment analysis ---按仓库 Notebook 与 Skills 文档规范name采用小写字母与连字符本技能即analyzing-financial-statements建议控制在 64 字符内description用于能力描述与触发匹配建议不超过 1024 字符。Frontmatter 之下才是指令阶段的正文能力清单、使用步骤、输入输出格式、最佳实践与局限性——这些构成了 Claude 执行任务时的行为准则。渐进式披露Progressive Disclosure机制贯穿始终元数据阶段始终可见以触发匹配指令阶段SKILL.md等所有.md文件在主题相关时才加载calculate_ratios.py、interpret_ratios.py等脚本属于资源阶段仅在需要执行计算时才按需读取。这正是该技能把知识与代码分层放置的设计逻辑。能力边界技能覆盖的六大财务比率体系SKILL.md的 Capabilities 一节给出了技能的完整计算域。技能的定位是财务健康体检覆盖公司经营分析的常见维度类别包含比率分析意义盈利能力ProfitabilityROE、ROA、毛利率、营业利润率、净利率企业赚取利润的能力与股东回报水平流动性Liquidity流动比率、速动比率、现金比率短期偿债能力与营运资金充足度杠杆/偿债Leverage资产负债率Debt-to-Equity、利息保障倍数、偿债覆盖率资本结构与长期偿债风险运营效率Efficiency资产周转率、存货周转率、应收账款周转率资产使用效率与营运管理质量估值ValuationP/E、P/B、P/S、EV/EBITDA、PEG市场对公司的定价水平与相对贵贱每股指标Per-ShareEPS、每股净资产、每股股息普通股股东视角下的收益与权益这些分类并非只停留在文档层面而是完整映射到了 calculate_ratios.py 中FinancialRatioCalculator类的五个分组方法上calculate_profitability_ratios()L33、calculate_liquidity_ratios()L61、calculate_leverage_ratios()L82、calculate_efficiency_ratios()L106与calculate_valuation_ratios()L130。因此只要补充每股股息口径的数据字段技能便可覆盖文档声明的全部指标。三步使用流程与真实输入格式SKILL.md把技能的交互收敛为三个步骤输入报表数据 → 指定要计算的比率或使用 all→ 获得计算结果与行业解读。典型触发语句包括Calculate key financial ratios for this company based on the attached financial statements Whats the P/E ratio if the stock price is $50 and annual earnings are $2.50 per share? Analyze the liquidity position using the balance sheet data技能可接受的输入格式有四种财务科目行的CSV、结构化报表的JSON、关键财务数据的文本描述以及含财务报表的Excel 文件。其中 JSON 是底层引擎最直接的输入形态——calculate_ratios.py 的FinancialRatioCalculator.__init__L13-L25会把传入字典拆解为四个命名空间income_statement利润表科目含revenue、cost_of_goods_sold、operating_income、ebit、ebitda、interest_expense、net_incomebalance_sheet资产负债表科目含total_assets、current_assets、cash_and_equivalents、accounts_receivable、inventory、current_liabilities、total_debt、current_portion_long_term_debt、shareholders_equitycash_flow现金流量表科目operating_cash_flow等为未来的现金流指标预留market_data市场数据含share_price、shares_outstanding、earnings_growth_rate。脚本文件末尾L310 起自带一份可直接运行的示例数据——收入 100 万美元、总资产 200 万美元、股本 150 万美元、股价 50 美元等——演示了文本/CSV 输入如何被结构化后喂给计算引擎。将SKILL.md中文本描述财务数据的能力与源码字典结构对照即可发现Claude 的工作就是把非结构化输入翻译成上述四个字典字段再交给脚本。输出格式与解读报告依据SKILL.md计算结果应包含计算出的比率与数值、可用时的行业基准对比、多期数据时的趋势分析、解读与洞见以及格式化的 Excel 报告。这一输出规范与 interpret_ratios.py 的实现一一呼应数值calculate_ratios.py中format_ratio()L229-L240按指标性质输出%毛利率、ROE 等百分比型、x周转/保障倍数、days应收天数或$每股金额行业基准对比与解读RatioInterpreter内置BENCHMARKS行业基准表L13-L48支持technology、retail、financial、manufacturing、healthcare五个行业及兜底的general基准逐项给出 Excellent/Good/Acceptable/Poor 评级和行动建议趋势分析analyze_trend()L187-L227对比首末两期数值计算变化幅度与方向识别 Stable/Improving/Deteriorating 趋势对杠杆类指标方向判定相反综合洞见perform_comprehensive_analysis()L261-L311汇总当期分析 趋势分析 整体健康度 优先级建议_assess_overall_health()L314-L350将各比率评级折算为 4 分制得分并给出公司财务健康度的整体判定generate_report()L229-L258则生成格式化的分析报告文本。也就是说interpret_ratios.py不只是简单翻译数值而是通过基准分级、方向判定、评分汇总三层逻辑把裸数值转化为可辅助决策的结论。这与文档中Industry benchmark comparisons、Trend analysis、Interpretation and insights的输出承诺完全对应。计算引擎逐类拆解六类比率的公式来源下面结合calculate_ratios.py各方法逐类核对指标公式方便你在改造技能时增减字段口径。盈利能力L33-L59ROE net_income / shareholders_equityROA net_income / total_assets毛利率 (revenue - cogs) / revenue内部先计算gross_profit营业利润率 operating_income / revenue净利率 net_income / revenue。流动性L61-L80流动比率 current_assets / current_liabilities速动比率酸性测试(current_assets - inventory) / current_liabilities即剔除存货的流动资产口径现金比率 cash_and_equivalents / current_liabilities最严苛的短期偿付口径。杠杆/偿债L82-L104资产负债率 D/E total_debt / shareholders_equity利息保障倍数 ebit / interest_expense偿债覆盖率 DSCR operating_income / (interest_expense current_portion_long_term_debt)——分母即当期需偿还的本息总和。运营效率L106-L128资产周转率 revenue / total_assets存货周转率 cogs / inventory应收账款周转率 revenue / accounts_receivable顺带推导应收账款周转天数 DSO 365 / receivables_turnover。估值与每股指标L130-L166EPS net_income / shares_outstandingP/E share_price / EPS每股净资产 BVPS shareholders_equity / shares_outstandingP/B share_price / BVPSP/S market_cap / revenue市值 股价 × 总股本EV/EBITDA (market_cap total_debt - cash) / ebitda企业价值扣除现金后对 EBITDA 的倍数PEG 仅在earnings_growth_rate 0时计算即PE / (growth_rate × 100)规避负增长导致的无意义结果。关键工程细节除零保护。所有除法都经由safe_divide()L27-L31——分母为零时返回默认值 0.0而不是抛 ZeroDivisionError。这让脚本在遇到缺失科目或零值字段时仍能稳定运行是财务数据常不完整场景下的必要健壮性设计。在 Notebook 中创建、上传并实测该 Skill在 skills/notebooks/03_skills_custom_development.ipynb 中该技能被作为自定义技能开发第一个完整示例L352 起进行演示完整链路为初始化客户端与目录L113-L124读取ANTHROPIC_API_KEY以anthropic-beta: skills-2025-10-02头创建Anthropic客户端SKILLS_DIR Path.cwd().parent / custom_skills清理潜在同名冲突L305-L345调用list_custom_skills(client)检查是否已存在名为 Financial Ratio Analyzer 的技能存在时先delete_skill()删除旧版本避免上传时报cannot reuse an existing display_title上传技能目录L380-L403create_skill(client, str(financial_skill_path), Financial Ratio Analyzer)底层调用client.beta.skills.create(display_title..., filesfiles_from_dir(skill_path))把整个analyzing-financial-statements目录打包上传成功后可取回skill_id与latest_version实测技能L421-L453以文本形式输入一份迷你财务数据收入 $1,000M、EBITDA $200M、净资产 $1,200M、股价 $50、股本 100M 等调用test_skill(client, financial_skill_id, test_prompt)触发一次包含该 custom skill 的 Messages API 请求从响应中提取文本输出作为验证。这套流程揭示了 Skill 的运行时机制Claude 收到用户的分析请求后依据元数据匹配到该技能加载SKILL.md指令再把计算逻辑外包给捆绑脚本执行——脚本负责确定性数值计算Claude 负责字段映射、结果组织与自然语言表达。可配合参考仓库中 sample_data/financial_statements.csv 这类报表样例快速构造更真实的测试输入。解读引擎行业基准、趋势与行动建议的落地细节如果说calculate_ratios.py解决算得准interpret_ratios.py则解决看得懂。其内部采用评级取向分治的策略越高越好型current_ratio、roe、gross_margin值达到excellent/good/acceptable基准线即依次评为 Excellent → Good → Acceptable低于最差线则为 Poor越低越好型debt_to_equity反向比较低于excellent阈值才是 Excellent资本结构非常保守估值语境型pe_ratio区分负盈利PE ≤ 0与正盈利区间再按 undervalued/fair/growth/expensive 四档给出潜在低估/合理/成长溢价/高估评级。每个评级还会通过_get_recommendation()L153-L185映射到一句可执行建议例如流动比率 Poor 时建议改善营运资金管理、降低短期债务或增加流动资产ROE Poor 时建议聚焦运营效率与盈利能力改善。在_generate_key_recommendations()L353 起中所有 Poor 评级会升级为 Priority: 前缀的最高优先级建议配合趋势下滑的 Monitor: 条目最终返回不超过 5 条的精炼行动清单。最佳实践与已知局限SKILL.md沉淀了此类技能在真实财务分析中的工程纪律写作与扩展技能时应一并遵守计算前校验数据完整性脚本对各字段用.get(key, 0)兜底缺字段返回 0但零值本身可能就是异常信号如股本为零导致 ROE0合理处理缺失值用行业均值补全或剔除该指标避免静默扭曲结论解释时必须考虑行业语境同一 D/E 在金融业基准可接受值 4.0与科技业可接受值 1.0含义天差地别务必选择匹配的行业基准提供多期数据做趋势对比analyze_trend()要求至少两个时期的数据单期输入只能给出截面结论标记异常/令人担忧的比率生成报告时对 Poor 评级与恶化趋势做显式标注。同时需要正视文档声明的局限分析依赖准确完整的财务数据BENCHMARKS基准表是简化的通用指导值各行业实际阈值需随业务调整部分比率并非适用所有行业如银行报表中 D/E、存货指标口径特殊历史数据不能保证未来表现任何结论都不应替代专业财务意见。从实现看interpret_ratios.py 注释也明确写明基准为 simplified for demonstration——扩展技能时建议把行业基准表升级为可外部配置的数据源并结合 applying-brand-guidelines 等技能共同使用的组合式工作流把财务分析结果直接落入品牌化报表。小结analyzing-financial-statements是一个文档即接口、脚本即实现的典型自定义 Skill 范本SKILL.md定义了技能的触发方式、能力边界与行为准则calculate_ratios.py以字段化字典与除零保护实现了六大类比率与每股指标的计算interpret_ratios.py则通过行业基准分级、趋势方向判定与综合健康度评分把数值翻译为可执行建议。开发者可参照该结构把任意分析领域估值建模、SaaS 指标、成本分析的知识沉淀为同样的三层架构——这也正是 Skills 机制区分于普通提示词的工程价值所在。【免费下载链接】claude-cookbooksA collection of notebooks/recipes showcasing some fun and effective ways of using Claude.项目地址: https://gitcode.com/GitHub_Trending/an/claude-cookbooks创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/8 17:54:21

YOLOv8集装箱缺陷检测实战:从数据标注到边缘部署全流程

简介:面向深度学习与工业视觉方向的学习者和开发者,YOLOv8集装箱缺陷识别项目围绕集装箱表面目标检测任务,提供从数据配置、模型训练到推理部署的完整工程化实现,适合具备Python基础、希望快速上手目标检测实战流程的读者参考。压…

2026/9/8 17:49:21

EXTI外部中断(STM32标准库学习笔记)

在上一章中,我们完成了OLED显示屏的调试,掌握了如何通过显示屏直观地查看单片机内部的数据变化。然而在实际的嵌入式开发中,仅仅依靠轮询方式去检测外部事件往往效率低下,甚至可能错过关键信号。这时,就需要引入中断机…

2026/9/8 17:49:21

FPGA以太网通信入门:从UDP回环到PHY芯片调试

前面几期咱们一直在跟按键、数码管、串口较劲,到了 part.7 这个位置,总有人跑过来问:FPGA 到底怎么跟电脑传数据?于是我们终于要碰 FPGA 的网络通信设计。先别慌,把它当成串口的一次升级就可以。串口是一个字节一个字节…

2026/9/8 22:00:08

如何快速精简 Windows 11 镜像,到底能省多少

如何快速精简 Windows 11 镜像,到底能省多少 【免费下载链接】tiny11builder Scripts to build a trimmed-down Windows 11 image. 项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder Windows 11 出厂就带一堆你用不上的应用,官方…

2026/9/8 22:00:08

数字藏品交易平台源码实测:从搭建部署到合规避坑全解析

简介:一份价值600元的仿鲸探模式NFT数字藏品艺术品交易平台源码,附完整搭建教程,面向想快速入局数字艺术品的开发者、创业者和收藏家。平台涵盖铸造发行、二级市场挂售、盲盒商城、碎片合成与邀请有礼等完整业务闭环,后台支持灵活…

2026/9/8 22:00:08

Codex报错排查指南:15种常见问题从安装到运行时全搞定

1. 排查前的准备工作:先看懂 Codex 的报错结构如果你最近在用 Codex 做 AI 编程辅助,应该有过这种经历:明明上一秒还跑得好好的,下一秒就蹦出一串看不懂的报错,什么config.toml、SystemExit、422全都来了。我在本地环境…

2026/9/8 21:55:07

基于人脸识别与步态识别的智能门禁系统设计与实现

简介:基于人脸识别与步态识别的智能门禁系统,是一份计算机视觉方向的毕设/课设源码包,附带系统说明文档,面向计科、人工智能、数据科学等专业在校生及开发人员。项目借助Python及开源视觉库实现人脸、步态双重生物特征认证&#x…

2026/9/8 7:15:10

超人会飞不算本事:系统稳定依赖清晰规则与边界设计

开头先不绕弯子。“#斯坦李吐槽dc 所以超人是无缘无故会飞的嘛哈哈哈哈哈哈哈锤哥真是技术人才啊!#雷神 #复联”这类调侃式短标题,第一波冲击力在于它把两个宇宙的角色塞进同一个吐槽箱里,但细想一下就能发现,它真正碰到的根本不是…

2026/9/8 7:15:15

超人VS蜘蛛侠:拆解超级IP的影响力与传播方法论

把“蜘蛛侠 vs 超人”放在 CSDN 上聊,可能很多人第一反应是走错片场了。但如果把这两个角色看成“两个持续运营了 80 多年的文化产品”,你会发现,这场比较本质上是两个不同 IP 策略的长期结果对比:超人赢在定义了整个超级英雄题材…

2026/9/8 7:15:10

基于CNN的调制信号识别:MATLAB实现时频图分类实战

简介:本资源是一套面向通信工程与信号处理方向学习者、研究者的深度学习实践方案,聚焦调制信号自动检测与识别这一典型无线通信任务,解决传统方法依赖人工特征、低信噪比下性能下降等痛点。压缩包共12个文件(10.73MB)&…

2026/9/8 0:01:49

踩多轮坑才跑通|OpenClaw 3.1.0 双平台本地 AI 自动化搭建实操实录

🔹 工具简述 OpenClaw 是一款备受开发者与办公人群青睐的开源本地智能工具,凭借离线本地运行、可视化图形面板、全流程自主任务处理三大核心特点,积累了众多忠实用户。与普通对话类 AI 产品不同,它能够直接调用电脑的软硬件操作权…

2026/9/8 0:01:50

拒绝复杂命令行,Hermes Agent 一键包快速解锁智能办公能力

🔍前言 不少想要体验 Hermes Agent 办公能力的使用者,往往会被复杂的环境配置拦住使用脚步。手动下载匹配依赖、反复调整系统目录、处理命令行持续报错、修复权限异常、补全丢失核心文件等一系列操作,对普通使用者而言门槛较高,很…

2026/9/7 16:23:03

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/7 22:46:00

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/7 22:45:59

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码