SuperAPI AI Directory

cold-start

General & other

View repository

Updated 10-16 08:46

About this skill

/finance:cold-start

Process Overview

Part 0:连接器检测
Part 1:公司配置
Part 2:场景选择
Part 3:关键阈值设置
Part 4:写入配置

Part 0: Connector Detection

Goal: Confirm which Connectors can actually work (not just configuration declarations).

Attempt to call a lightweight API for each candidate Connector:

  • SAP → Read company name GET /sap/bc/rest/company
  • Power BI → Read workspace list GET /v1.0/myorg/groups
  • BlackLine → Read account list GET /api/v2023.1/accounts
  • Concur → Read user profile GET /api/v4/user

For each Connector:

  • ✅ Successful response → Mark Operational
  • ⚠️ Configuration exists but call failed → Mark Configured-unreachable + one-line fix note
  • ❌ Not configured → Mark Not configured

Output connector status table:

| Connector | 系统 | 状态 | 说明 |
|-----------|------|------|------|
| sap_* | SAP S/4HANA | ✅ Operational | 公司代码: [CODE] |
| pbi_* | Power BI | ⚠️ Configured-unreachable | 检查 API 权限 |
| bl_* | BlackLine | ❌ Not configured | 运行 /finance:connector-setup bl |

Part 1: Company Configuration

Goal: Collect company-level financial information, write to ~/.config/finance-skills/CLAUDE.md。

Ask in sequence:

Q1: ERP system

你们公司用哪个 ERP 系统?
1. SAP S/4HANA
2. Oracle EBS / Fusion
3. 用友 NC / U8 / Cloud
4. 金蝶 K3 / Cloud
5. 其他(请说明)

Q2: Finance function structure

财务团队结构是怎样的?
1. 共享中心 SSC(财务共享中心)
2. 分散型(每个业务单元有独立财务)
3. 混合型(共享中心 + 部分分散)

Q3: Audit cycle

审计周期是什么?
1. 自然年(1月1日~12月31日)
2. 财年(请说明起始月,如 4月1日~次年3月31日)

Q4: Main financial systems (multiple choice)

除了 ERP,你们还用哪些财务系统?
□ Power BI / Tableau(管理报表)
□ BlackLine(账户对账/关账)
□ SAP Concur / Expensify(差旅报销)
□ Kyriba / GTreasury(司库管理)
□ Bloomberg(外汇/市场数据)
□ 其他(请说明)

Part 2: Scenario Selection

Goal: Confirm which financial scenario capabilities the user needs.

Display the category map of 29 scenarios:

┌─────────────────────────────────────────────────────────────┐
│  交易级(Transaction)                                      │
│  AP / AR / GL / 固定资产 / 工资 / 集团内往来              │
├─────────────────────────────────────────────────────────────┤
│  报告级(Reporting)                                        │
│  管理报告 / 董事会汇报 / 月结 / KPI / 费用审查               │
├─────────────────────────────────────────────────────────────┤
│  分析级(Analysis)                                         │
│  财务分析 / 商业洞察 / 成本控制 / 预算管理                   │
├─────────────────────────────────────────────────────────────┤
│  战略级(Strategic)                                        │
│  融资结构 / M&A / 投资管理 / 外汇风险 / ESG / 司库         │
├─────────────────────────────────────────────────────────────┤
│  合规级(Compliance)                                       │
│  内控设计 / 内控测试 / 审计支持 / 税务申报                   │
├─────────────────────────────────────────────────────────────┤
│  投资者关系 / 战略规划 / 资本配置                            │
└─────────────────────────────────────────────────────────────┘

Ask:

你目前最需要哪些场景?(可多选,例如 "内控 + 董事会汇报 + 税务")
或者输入 "全部" 安装所有场景。

Based on the user's selection, in CLAUDE.md mark the selected scenarios in the scenario table.


Part 3: Key Threshold Settings

Goal: Set key thresholds for each scenario (quantitative standards that affect the judgment framework).

For selected scenarios, ask for key thresholds:

Internal control scenario (if selected)

【内控缺陷评级阈值】
重大缺陷(Material Weakness)金额门槛:RMB [  500 ] 万
重要缺陷(Significant Deficiency)金额门槛:RMB [  100 ] 万

(提示:参考 SOX 404 和公司财务重要性水平)

Expense compliance scenario (if selected)

【差旅/费用超标阈值】
住宿费超标:超过标准 [  20 ]%
餐费超标:超过标准 [  15 ]%
单次超规审批层级:[部门负责人] 级

Budget scenario (if selected)

【预算偏差预警阈值】
收入偏差预警:低于预算 [  -5 ]%
成本偏差预警:超过预算 [   5 ]%
重大偏差需要:[CFO] 审批

Thresholds are written to each scenario's references/数据源清单.md, under the threshold: field.


Part 4: Write Configuration

Output target:

~/.config/finance-skills/           ← 用户配置根目录(与 Legal 一致)
├── CLAUDE.md                      ← 公司级配置
├── credentials/                   ← API 密钥(不暴露给 Agent)
│   ├── sap.env
│   ├── pbi.env
│   └── bl.env
├── audit.log                      ← 操作日志
└── projects/                      ← 项目空间
    └── README.md

Update references/数据源清单.md Connector mapping in, inject the detected system connection status.


--check-connections flag

Run only Part 0 (connector detection), update CLAUDE.md connector status table in , without modifying other configurations.

/finance:cold-start --check-connections

--redo flag

Reset all configurations, rerun the complete process.will overwrite existing configurations。

/finance:cold-start --redo

Dependencies

This Skill depends on:

  • CONNECTORS.md(Part 0 connector detection needs to know which Connectors are available)
  • PROJECT_WORKSPACE.md(understand the project directory structure)
  • Each scenario's references/数据源清单.md(write thresholds)

Before the first run, check whether these files exist; if they do not exist, give a warning.


Fallback

If unable to connect to any financial system:

  1. Mark all Connectors as Offline mode
  2. Inform the user: the Skill will run in manual input mode (user provides data, Agent outputs judgment)
  3. This is a usable state, just less efficient