@axiom-lattice/examples-deep_research 1.0.26 → 1.0.27

package/src/agents/data_agent/skills/financial-analysis/SKILL.md

@@ -0,0 +1,268 @@
+---
+name: financial-analysis
+description: 执行财务数据分析，包括毛利分析、财务报表分析、财务比率分析三大模块。适用于评估企业财务健康状况和盈利能力。
+metadata:
+  category: financial_analysis
+parentSkill: business-analytics
+---
+
+## 分析模块
+
+### 模块一：毛利分析
+
+#### 分析维度
+- **产品线维度**：各产品线的毛利率对比
+- **客户维度**：不同客户/客户群的毛利率分析
+- **时间维度**：毛利率趋势变化（月/季/年）
+- **区域维度**：不同销售区域的毛利率对比
+
+#### 关键指标
+```
+毛利率 = (销售收入 - 销售成本) / 销售收入 × 100%
+毛利额 = 销售收入 - 销售成本
+贡献毛利 = 毛利额 - 变动费用
+```
+
+#### 分析流程
+
+1. **数据准备**
+   - 收入数据：按产品/客户/区域/时间汇总
+   - 成本数据：直接材料、直接人工、制造费用
+   - 费用数据：变动费用分摊
+
+2. **计算毛利率**
+   - 计算各维度毛利率
+   - 识别高/低毛利项目
+
+3. **对比分析**
+   - 同比/环比趋势
+   - 目标达成率
+   - 行业基准对比
+
+4. **贡献分析**
+   - 毛利额贡献占比
+   - 产品/客户组合分析
+   - 交叉补贴分析
+
+5. **输出模板**
+
+```markdown
+## 毛利分析报告
+
+### 执行摘要
+- 总体毛利率：[X]%，同比[上升/下降][X]个百分点
+- 关键发现：[2-3条核心发现]
+- 核心建议：[2-3条具体建议]
+
+### 产品线毛利率分析
+| 产品线 | 销售收入 | 销售成本 | 毛利额 | 毛利率 | 同比变化 |
+|-------|---------|---------|-------|-------|---------|
+| 产品A | | | | | |
+| 产品B | | | | | |
+
+### 趋势分析
+- 图表：毛利率月度趋势图
+- 分析：[趋势解读]
+
+### 改进建议
+1. [具体建议1]
+2. [具体建议2]
+```
+
+---
+
+### 模块二：财务报表分析
+
+#### 报表类型
+
+**1. 资产负债表**
+```
+资产端：
+- 流动资产：现金、应收账款、存货、预付款项
+- 非流动资产：固定资产、无形资产、长期投资
+
+负债及权益端：
+- 流动负债：短期借款、应付账款、预收款项
+- 非流动负债：长期借款、应付债券
+- 所有者权益：实收资本、留存收益
+```
+
+**2. 利润表（损益表）**
+```
+营业收入
+- 营业成本
+= 营业毛利
+- 期间费用（销售/管理/财务费用）
+= 营业利润
++ 营业外收支
+= 利润总额
+- 所得税
+= 净利润
+```
+
+**3. 现金流量表**
+```
+经营活动现金流
+投资活动现金流
+筹资活动现金流
+= 现金净增加额
+```
+
+#### 分析内容
+
+1. **结构分析**
+   - 资产负债结构
+   - 收入成本结构
+   - 现金流构成
+
+2. **变动分析**
+   - 同比变动
+   - 环比变动
+   - 重大变动说明
+
+3. **异常标注**
+   - 超出正常范围的指标
+   - 异常波动项
+   - 需关注科目
+
+#### 输出模板
+
+```markdown
+## 财务报表分析
+
+### 资产负债表（[日期]）
+| 项目 | 本期金额 | 上期金额 | 变动额 | 变动率 | 异常标注 |
+|-----|---------|---------|-------|-------|---------|
+| 流动资产 | | | | | |
+| 非流动资产 | | | | | |
+| 资产合计 | | | | | |
+
+### 利润表（[期间]）
+| 项目 | 本期金额 | 上期金额 | 变动额 | 变动率 | 占比 |
+|-----|---------|---------|-------|-------|-----|
+| 营业收入 | | | | | |
+| 营业成本 | | | | | |
+| 毛利率 | | | | | |
+
+### 关键发现
+- [发现1]
+- [发现2]
+```
+
+---
+
+### 模块三：财务比率分析
+
+#### 盈利能力比率
+
+```
+销售毛利率 = 毛利 / 营业收入 × 100%
+销售净利率 = 净利润 / 营业收入 × 100%
+净资产收益率(ROE) = 净利润 / 平均净资产 × 100%
+总资产收益率(ROA) = 净利润 / 平均总资产 × 100%
+投入资本回报率(ROIC) = 税后营业利润 / 投入资本 × 100%
+```
+
+#### 偿债能力比率
+
+```
+流动比率 = 流动资产 / 流动负债
+速动比率 = (流动资产 - 存货) / 流动负债
+资产负债率 = 总负债 / 总资产 × 100%
+利息保障倍数 = 息税前利润 / 利息费用
+```
+
+#### 运营效率比率
+
+```
+应收账款周转率 = 营业收入 / 平均应收账款
+存货周转率 = 营业成本 / 平均存货
+总资产周转率 = 营业收入 / 平均总资产
+固定资产周转率 = 营业收入 / 平均固定资产净值
+```
+
+#### 分析流程
+
+1. **计算比率**
+   - 基于财务报表数据计算各项比率
+   - 按时间序列整理
+
+2. **趋势分析**
+   - 绘制比率趋势图
+   - 识别上升/下降趋势
+
+3. **对比分析**
+   - 与历史数据对比
+   - 与行业基准对比
+   - 与竞争对手对比
+
+4. **综合评估**
+   - 杜邦分析：ROE = 净利率 × 资产周转率 × 权益乘数
+   - 识别驱动因素
+
+#### 输出模板
+
+```markdown
+## 财务比率分析报告
+
+### 盈利能力指标
+| 指标 | 本期值 | 上期值 | 行业均值 | 评价 |
+|-----|-------|-------|---------|-----|
+| ROE | | | | |
+| ROA | | | | |
+| 毛利率 | | | | |
+
+### 偿债能力指标
+| 指标 | 本期值 | 安全标准 | 评价 |
+|-----|-------|---------|-----|
+| 流动比率 | | >1.5 | |
+| 资产负债率 | | <60% | |
+
+### 趋势分析
+- 图表：关键比率趋势图
+- 分析：[趋势解读]
+
+### 综合评价
+- 优势：[优势领域]
+- 劣势：[需要改善的领域]
+- 建议：[改进措施]
+```
+
+---
+
+## 通用分析流程
+
+### 步骤 1：问题理解
+- 明确分析类型（毛利/报表/比率）
+- 确定分析维度（产品/客户/时间/区域）
+- 明确分析期间
+
+### 步骤 2：数据检索
+- 检索收入数据
+- 检索成本数据
+- 检索费用数据
+- 检索资产负债数据
+
+### 步骤 3：计算与对比
+- 计算关键指标
+- 进行同比/环比分析
+- 与目标/行业对比
+
+### 步骤 4：可视化
+- 趋势图：展示时间序列变化
+- 对比图：展示维度间差异
+- 结构图：展示构成比例
+
+### 步骤 5：洞察与建议
+- 识别关键发现
+- 分析原因
+- 提出改进建议
+
+## 常见问题与解决方案
+
+| 问题 | 解决方案 |
+|-----|---------|
+| 成本数据不完整 | 与运营部门确认成本归集方法 |
+| 毛利率异常波动 | 检查是否存在一次性收入/成本 |
+| 比率与行业差异大 | 分析业务模式差异 |
+| 数据口径不一致 | 统一数据定义和计算口径 |

package/src/agents/data_agent/skills/generate-chart-md/SKILL.md

@@ -0,0 +1,176 @@
+---
+name: generate-chart-md
+description: Generate chart markdown content fragments (with ECharts config) for analysis results. Use when output should include bar, line, pie, scatter, or heatmap charts as embeddable markdown snippets.
+metadata:
+  category: generate-report
+---
+
+## 图表类型选择指南
+
+根据数据特征和业务问题选择最合适的图表类型：
+
+- **柱状图** (bar): 比较类别或时间周期
+  - 使用 category xAxis，value yAxis
+  - 多系列用于分组/堆叠柱状图
+- **折线图** (line): 展示时间趋势
+  - 使用 category/time xAxis，value yAxis
+  - 多系列展示多个指标
+- **饼图** (pie): 展示构成/百分比
+  - 无需 xAxis/yAxis
+  - 数据格式: [{value: number, name: string}, ...]
+  - 使用 radius: ["40%", "70%"] 创建环形图
+- **散点图** (scatter): 相关性分析
+  - 使用 value xAxis 和 value yAxis
+  - 数据格式: [[x, y], [x, y], ...]
+- **热力图** (heatmap): 多维数据
+  - 需要 category xAxis 和 yAxis
+  - 数据格式: [[xIndex, yIndex, value], ...]
+
+## ECharts 配置要求
+
+生成完整的 ECharts 配置，必须包含：
+
+\`\`\`chart
+{
+"table": [...], // 原始数据表格
+"echarts": {
+"title": {"text": "清晰的图表标题"},
+"tooltip": {
+"trigger": "axis", // bar/line 用 "axis", pie/scatter 用 "item"
+"formatter": "..." // 可选：自定义格式化
+},
+"legend": {...}, // 多系列时必需
+"xAxis": {
+"type": "category", // 或 "time", "value"
+"name": "X 轴名称",
+"data": [...] // category 类型时必需
+},
+"yAxis": {
+"type": "value",
+"name": "Y 轴名称"
+},
+"series": [{
+"type": "bar|line|pie|scatter|heatmap",
+"name": "系列名称",
+"data": [...],
+"label": {...} // 可选：显示数值
+}],
+"grid": {...} // 可选：控制边距
+}
+}
+\`\`\`
+
+## 最佳实践
+
+- 图表标题清晰描述业务问题
+- 轴标签使用业务术语，而非技术字段名
+- 数值格式化：百分比、货币、千分位
+- 时间序列使用 "xAxis.type: 'time'" 并正确格式化日期
+- 多系列时使用 legend 区分
+- 重要数值在图表上直接标注（series.label）
+
+## 使用场景
+
+### 场景1：销售数据可视化
+用户需要展示各区域销售额对比，或月度销售趋势。
+
+### 场景2：财务指标展示
+展示收入构成、成本结构或利润率变化趋势。
+
+### 场景3：运营数据分析
+展示用户增长、留存率、转化率等运营指标。
+
+## 完整示例
+
+### 示例1：柱状图 - 销售额对比
+
+```chart
+{
+  "table": [
+    {"region": "华北", "sales": 120},
+    {"region": "华东", "sales": 200},
+    {"region": "华南", "sales": 150}
+  ],
+  "echarts": {
+    "title": {"text": "各区域销售额对比"},
+    "tooltip": {"trigger": "axis"},
+    "xAxis": {
+      "type": "category",
+      "data": ["华北", "华东", "华南"],
+      "name": "区域"
+    },
+    "yAxis": {
+      "type": "value",
+      "name": "销售额(万元)"
+    },
+    "series": [{
+      "type": "bar",
+      "data": [120, 200, 150],
+      "label": {"show": true, "position": "top"}
+    }]
+  }
+}
+```
+
+### 示例2：折线图 - 月度趋势
+
+```chart
+{
+  "table": [
+    {"month": "1月", "revenue": 100},
+    {"month": "2月", "revenue": 120},
+    {"month": "3月", "revenue": 150}
+  ],
+  "echarts": {
+    "title": {"text": "月度收入趋势"},
+    "tooltip": {"trigger": "axis"},
+    "xAxis": {
+      "type": "category",
+      "data": ["1月", "2月", "3月"],
+      "name": "月份"
+    },
+    "yAxis": {
+      "type": "value",
+      "name": "收入(万元)"
+    },
+    "series": [{
+      "type": "line",
+      "data": [100, 120, 150],
+      "smooth": true,
+      "label": {"show": true}
+    }]
+  }
+}
+```
+
+### 示例3：饼图 - 收入构成
+
+```chart
+{
+  "table": [
+    {"category": "产品A", "value": 40},
+    {"category": "产品B", "value": 30},
+    {"category": "产品C", "value": 20},
+    {"category": "其他", "value": 10}
+  ],
+  "echarts": {
+    "title": {"text": "收入构成分析"},
+    "tooltip": {"trigger": "item", "formatter": "{b}: {c} ({d}%)"},
+    "series": [{
+      "type": "pie",
+      "radius": ["40%", "70%"],
+      "data": [
+        {"value": 40, "name": "产品A"},
+        {"value": 30, "name": "产品B"},
+        {"value": 20, "name": "产品C"},
+        {"value": 10, "name": "其他"}
+      ],
+      "label": {"show": true, "formatter": "{b}: {d}%"}
+    }]
+  }
+}
+```
+
+## 输出格式
+
+提供完整的 chart JSON 配置，可直接用于渲染。代码块语言标识必须为 `chart`。