Finance Skills

AI-Ready Financial Intelligence — 覆盖 CFO 全部工作域的智能体 Skill 体系

是什么

Finance Skills 是一套面向 AI Agent 的财务职能 Skill 系统。每个 Skill 对应一个财务场景中的具体任务，Agent 加载后可以自主完成从数据读取、判断到输出的完整工作流。

解决问题：让 AI Agent 具备财务专业能力——不是通用聊天，而是能真正执行"内控测试""KPI 根因分析""IFRS 9 信用风险评估"这类任务的财务助手。

架构总览

finance-skills/
├── FINANCE-SKILLS-OVERVIEW.html   ← 可视化图谱（浏览器直接打开）
├── finance-skills/
│   ├── ARCHITECTURE.md            ← 工程架构说明
│   ├── CLAUDE.md                  ← 全局配置模板
│   ├── CONNECTORS.md              ← 9 个 Connector 定义（SAP/Power BI/BlackLine/Bloomberg...）
│   ├── PROJECT_WORKSPACE.md       ← 项目空间规范
│   ├── cold-start/                ← 首次配置向导
│   └── skills/                    ← 34 个财务场景
│       ├── internal-control/
│       ├── kpi-management/
│       └── ...
└── diagram/
    ├── FINANCE-SKILLS-OVERVIEW.html
    └── 财务职能体系全览.html           ← 早期设计稿（参考保留）

三层架构：

核心概念

Skill 类型

每个场景下有两种 Skill：

场景知识后端

每个场景目录下包含三个知识文件，供 Skill 运行时读取：

• 判断框架.md — 财务判断规则（YAML/表格），如内控缺陷分级标准、KPI 选择逻辑
• 数据源清单.md — 场景所需数据 → Connector → 系统/表/字段 映射
• 查询路径.md — 无 Connector 时的手动 SOP，引导用户完成数据收集

Connector 生态

9 个 Connector，覆盖 5 层架构：

L1 ERP      SAP S/4HANA, Oracle EBS/Fusion, 用友 NC/U8, 金蝶 K3
L2 BI       Power BI, Tableau, FineReport（帆软）
L3 执行     BlackLine, SAP Concur, Expensify, Kyriba, GTreasury, Bloomberg TSOX, Refinitiv Eikon, Capital IQ, Wind, AuditBoard
L4 合规     SharePoint, Google Drive, Workday Adaptive, Anaplan, Tagetik, CCH Tagetik, Workiva
L5 HR/税务  Workday HCM, BambooHR, ADP, TaxDome, Vertex/Sovos
L5 ESG/IR   Sustainalytics, MSCI ESG, Bloomberg ESG, Diligent, Q4

场景全景（34 个）

战略级（A 级）— 17 个

运营级（B 级）— 17 个

注：部分运营场景（budget-management、expense-review、month-end-close 等）为纯 Atomic 编排，无 Master Skill。

快速开始

1. 安装 Skill

# 方式一：软链接到 Hermes
ln -s /path/to/finance-skills/finance-skills ~/.hermes/skills/finance

# 方式二：在 SOUL.md 中配置引用路径

2. 首次配置（冷启动）

/hermes
> /finance:cold-start

或直接触发关键词：开始配置财务技能、初始化 finance、cold start

冷启动流程：

1. 连接器检测 — 验证 SAP / Power BI / BlackLine 等系统可达性
2. 公司配置 — 收集 ERP 类型 / 审计周期 / 财务职能结构
3. 场景选择 — 选择相关场景（可多选）
4. 阈值设置 — 配置内控缺陷分级标准、KPI 基准值等
5. 持久化 — 写入 ~/.config/finance-skills/CLAUDE.md

3. 使用场景 Skill

Hermes/Agent: 加载场景 Skill
    ↓
Master Skill: 识别用户意图
    ↓
Atomic Skill: 执行具体任务
    ↓
references/: 读取判断框架 + 数据源映射
    ↓
Connector: 调用外部系统
    ↓
输出结果（报告/判断/建议）

Skill 文件结构

skills/[场景]/
├── CLAUDE.md                 ← 用户配置（公司名称/阈值/联系人）
├── references/
│   ├── 判断框架.md            ← 财务判断规则（YAML/表格）
│   ├── 数据源清单.md          ← 数据 → Connector → 字段 映射
│   └── 查询路径.md            ← SOP（无 Connector 时的手动流程）
└── skills/
    ├── [scene]-master/       ← 场景主技能
    │   └── SKILL.md
    └── [atomic-skill]/       ← 原子技能
        └── SKILL.md

每个 SKILL.md 包含：

---
name: [skill-name]
description: [能力描述]
argument-hint: "[参数格式]"
risk_level: [low|medium|high]
version: "1.0.0"
---

## Examples
> 用户说"...", 调用本技能

## 加载上下文
首次使用时读取 `../../CLAUDE.md` 获取场景级配置

## 第一步 / 第二步 / ...
[可执行步骤：判断 → 工具调用 → 输出]

与 Legal Skill 体系的关系

Finance Skills 与 Greater China Legal（大中华区法律 Agent Skill 体系）同源，遵循相同的工程规范：

两者可同时加载于同一 Agent，会话中按意图自动路由。

文件统计

质量状态：所有 SKILL.md 文件 frontmatter ✅ + Examples ✅ 100%

技术栈

• Agent 框架：Hermes Agent / OpenClaw
• Skill 格式：Markdown（SKILL.md + YAML frontmatter）
• 知识后端：Markdown 表格/YAML（判断框架、数据源清单、查询路径）
• 系统集成：MCP（Model Context Protocol）Connector
• 可视化：HTML5 + CSS3（FINANCE-SKILLS-OVERVIEW.html）

目录深度

finance-skills/finance-skills/skills/[scene]/skills/[skill]/SKILL.md
         1           2       3        4         5         6

共 6 层。相对路径 ../../CLAUDE.md 从 Skill 文件指向场景根目录（路径深度不变）。

License

MIT License — 可自由用于个人和商业项目。

作者

vivy-yi · GitHub: @vivy-yi