上市公司财报分析助手
自动提取上市公司财报数据，计算财务比率、生成可视化图表，并输出专业分析报告。
评估显示技能操作范围合理：仅执行财务报告文件解析、比率计算和图表生成，使用专用工具 execute_skill_script_file，且不涉及外部网络请求或敏感数据外传。但用户确认机制缺失，脚本由主代理自动执行，用户未参与关键步骤确认；最小权限原则未明确提及，可能存在过度权限风险。未见回滚或恢复机制。因此得分为10，扣分原因：缺少用户确认步骤、权限说明不完整、无回滚方案。
技能流程清晰，脚本职责明确，关键路径可复制。错误处理有限：extract_financials.py 对文件不存在、读取失败和空文件有错误返回，但 calculate_ratios.py 和 generate_charts.py 对输入无效数据仅做降级处理（如设为默认值0），错误信息不充分。依赖如 pdfplumber 和 matplotlib 在知识文档中提及但无安装说明。静态评估无法执行验证，因此得分7，扣分原因：测试缺失，错误反馈不足，依赖说明不完整。
技能针对中国上市公司财报分析有明确目标用户和场景，文档详尽。能力边界部分界定：支持PDF和文本文件，但未明确说明不支持的格式（如扫描版PDF）或对非标准财报的处理。触发条件通过描述和流程较清晰。环境适配方面，脚本包含中文支持，但图表生成依赖系统字体，未提供安装字体指南；核心功能未依赖海外服务，大陆可访问性良好。得分9，扣分原因：非适用边界和触发条件说明不足。
信息架构分层良好：SKILL.md 提供流程，references 提供指标和分析框架，templates 提供交付模板。依赖和安装说明缺失（pdfplumber、matplotlib）。无版本号或变更日志，维护责任未明确。许可为MIT，来源清晰。示例流程完整，无FAQ。已知限制部分提及（排版影响），但不全面。得分9，扣分原因：缺少安装说明、版本管理、维护责任和FAQ。
技能目标明确，能够自动提取数据、计算比率、生成图表并产出报告，价值清晰。但输出完整性依赖LLM的深度分析质量，报告格式为HTML，用户需通过平台查看，直接可用性未验证。边际效益相较于手动分析明显，但成本效益比未量化。静态评估无法验证输出是否满足期望，得分6，扣分原因：无实际执行验证输出质量，比较优势证据不足。
提供了脚本代码，可审计，但无测试覆盖技能的关键路径。计算逻辑可静态审计，但提取准确性依赖正则对财报文本的匹配，未验证。无第三方执行证据或CI针对此技能的测试。得分4，扣分原因：无测试套件，无独立执行验证，关键声明（如提取准确性）无法复现。
- 技能中的脚本将自动执行，可能读取任意文件路径，应确保用户输入的文件路径可信并实施必要的权限限制。
- 图表生成依赖matplotlib及相关中文字体，文档未提供安装指南，可能因字体缺失导致图表中文乱码。
- 财务数据提取依赖正则表达式，可能因财报排版差异导致提取不准确，建议增加人工核对环节。
这个 Skill 能做什么，适合哪些场景？
该技能专为上市公司年报、季报等财报的深度分析设计。它能够解析 PDF 或文本格式的财报文件，自动提取营收、净利润等关键数据，计算毛利率、净利率、ROE 等核心财务比率，并生成三类可视化图表。技能内置了多维度的分析框架，指导 AI 从盈利质量、偿债风险、营运效率和现金流等角度撰写七段深度分析文本，最终通过 HTML 模板渲染成一份完整的财报分析报告。整个过程高度自动化，适合投资研究、财务分析和尽职调查等场景。
- 通过 execute_skill_script_file 执行 extract_financials.py，读取 PDF（用 pdfplumber）或文本财报，提取营收、净利润、资产、负债等核心财务数据，返回 JSON 格式。
- 调用 calculate_ratios.py，基于提取的数据自动计算毛利率、净利率、ROE、资产负债率等 30 个关键指标，并输出模板占位符键值。
- 执行 generate_charts.py，生成 3 张图表：核心财务指标对比柱状图（financial_overview.png）、盈利能力横向条形图（profitability.png）、资产结构环形饼图（asset_structure.png）。
- 参考 references/financial_metrics.md 和 references/analysis_framework.md，LLM 按照盈利质量、偿债风险、营运效率、现金流四个维度撰写七段分析文本（包括优势列表和风险列表）。
- 调用 html_interpreter，通过 template_path 模式读取 templates/report_template.html，自动合并数据指标、图表 URL 和分析文本，渲染成最终 HTML 报告。
- 最后调用 terminate 返回简短摘要，报告以卡片形式展示在左侧面板。
- 投资分析师需要快速分析上市公司年度财报，提取关键财务指标并生成报告
- 财务顾问为客户进行财报解读，需要自动生成包含图表和深度分析的报告
- 研究机构批量分析多家公司季度报告，希望自动化流程提高效率
- 个人投资者阅读财报PDF时，希望通过AI辅助理解财务数据和风险
- 金融机构进行贷前尽职调查，需要结构化分析借款企业的财务状况
这个 Skill 有哪些优点和局限？
- 高度自动化：从PDF提取到报告生成全流程自动化，节省大量人工整理时间
- 深度分析：内置分析框架，从盈利、偿债、运营、现金流四个维度全方位剖析
- 可视化：自动生成三张专业图表，直观展示财务结构
- 可定制：通过修改模板和参考文档，可以调整报告风格和分析重点
- 依赖特定平台：脚本设计为在 DB-GPT 环境中运行，使用 execute_skill_script_file 和 html_interpreter 等特有工具，迁移到其他 Agent 平台需要适配
- PDF解析准确性受文档排版影响，可能提取错误数值，需要人工核对
- 缺少测试套件，脚本在不同操作系统或 Python 版本下的稳定性未验证
- 仅支持 PDF 和文本格式，不支持 Excel 等电子表格输入
如何安装这个 Skill？
该技能包含在 DB-GPT 开源项目中（GitHub: eosphoros-ai/DB-GPT），需要克隆整个仓库。安装 DB-GPT 后，技能位于 skills/financial-report-analyzer/ 目录。具体安装步骤：
- 克隆仓库：git clone https://github.com/eosphoros-ai/DB-GPT.git
- 按照 README 中的快速开始指南安装 DB-GPT（例如使用一键安装脚本：curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh | bash）
- 确保环境满足 Python 3.10+，并安装 matplotlib 库（generate_charts.py 依赖）。
- 启动 DB-GPT 服务后，技能应该已经包含在内。
如何使用这个 Skill？
在 DB-GPT 对话界面中，直接向 AI 提出财报分析需求，例如：
“请分析这份年度财报：/path/to/your/report.pdf”
AI 会自动调用该技能，按流程提取数据、计算比率、生成图表并输出报告。你也可以指定报表文件路径，并期待最终生成的 HTML 报告卡片。