| name | cold-start |
| description | Finance Skills 首次配置向导。检测连接器状态、收集公司配置、 选择相关场景、设置关键阈值。首次使用 Finance Skills 时必须运行此向导。 触发词："开始配置"、"初始化财务技能"、"财务助手设置"、 "cold start"、"setup finance"
|
| argument-hint | [--check-connections] [--redo] |
/finance:cold-start
流程概览
Part 0：连接器检测
Part 1：公司配置
Part 2：场景选择
Part 3：关键阈值设置
Part 4：写入配置
Part 0：连接器检测
目标：确认哪些 Connector 能够实际工作（不只是配置声明）。
尝试调用每个候选 Connector 的轻量 API：
- SAP → 读取公司名称
GET /sap/bc/rest/company
- Power BI → 读取工作区列表
GET /v1.0/myorg/groups
- BlackLine → 读取账户列表
GET /api/v2023.1/accounts
- Concur → 读取用户档案
GET /api/v4/user
对每个 Connector：
- ✅ 成功响应 → 标记
Operational
- ⚠️ 配置存在但调用失败 → 标记
Configured-unreachable + 一行修复说明
- ❌ 未配置 → 标记
Not configured
输出连接器状态表：
| Connector | 系统 | 状态 | 说明 |
|-----------|------|------|------|
| sap_* | SAP S/4HANA | ✅ Operational | 公司代码: [CODE] |
| pbi_* | Power BI | ⚠️ Configured-unreachable | 检查 API 权限 |
| bl_* | BlackLine | ❌ Not configured | 运行 /finance:connector-setup bl |
Part 1：公司配置
目标：收集公司级财务信息，写入 ~/.config/finance-skills/CLAUDE.md。
依次询问：
Q1：ERP 系统
你们公司用哪个 ERP 系统？
1. SAP S/4HANA
2. Oracle EBS / Fusion
3. 用友 NC / U8 / Cloud
4. 金蝶 K3 / Cloud
5. 其他（请说明）
Q2：财务职能结构
财务团队结构是怎样的？
1. 共享中心 SSC（财务共享中心）
2. 分散型（每个业务单元有独立财务）
3. 混合型（共享中心 + 部分分散）
Q3：审计周期
审计周期是什么？
1. 自然年（1月1日～12月31日）
2. 财年（请说明起始月，如 4月1日～次年3月31日）
Q4：主要财务系统（多选）
除了 ERP，你们还用哪些财务系统？
□ Power BI / Tableau（管理报表）
□ BlackLine（账户对账/关账）
□ SAP Concur / Expensify（差旅报销）
□ Kyriba / GTreasury（司库管理）
□ Bloomberg（外汇/市场数据）
□ 其他（请说明）
Part 2：场景选择
目标：确认用户需要哪些财务场景的能力。
展示 29 个场景的分类地图：
┌─────────────────────────────────────────────────────────────┐
│ 交易级（Transaction） │
│ AP / AR / GL / 固定资产 / 工资 / 集团内往来 │
├─────────────────────────────────────────────────────────────┤
│ 报告级（Reporting） │
│ 管理报告 / 董事会汇报 / 月结 / KPI / 费用审查 │
├─────────────────────────────────────────────────────────────┤
│ 分析级（Analysis） │
│ 财务分析 / 商业洞察 / 成本控制 / 预算管理 │
├─────────────────────────────────────────────────────────────┤
│ 战略级（Strategic） │
│ 融资结构 / M&A / 投资管理 / 外汇风险 / ESG / 司库 │
├─────────────────────────────────────────────────────────────┤
│ 合规级（Compliance） │
│ 内控设计 / 内控测试 / 审计支持 / 税务申报 │
├─────────────────────────────────────────────────────────────┤
│ 投资者关系 / 战略规划 / 资本配置 │
└─────────────────────────────────────────────────────────────┘
询问：
你目前最需要哪些场景？（可多选，例如 "内控 + 董事会汇报 + 税务"）
或者输入 "全部" 安装所有场景。
根据用户选择，在 CLAUDE.md 的场景表中标记已选场景。
Part 3：关键阈值设置
目标：设置各场景的关键阈值（影响判断框架的量化标准）。
对已选场景，询问关键阈值：
内控场景（如果选择了）
【内控缺陷评级阈值】
重大缺陷（Material Weakness）金额门槛：RMB [ 500 ] 万
重要缺陷（Significant Deficiency）金额门槛：RMB [ 100 ] 万
（提示：参考 SOX 404 和公司财务重要性水平）
费用合规场景（如果选择了）
【差旅/费用超标阈值】
住宿费超标：超过标准 [ 20 ]%
餐费超标：超过标准 [ 15 ]%
单次超规审批层级：[部门负责人] 级
预算场景（如果选择了）
【预算偏差预警阈值】
收入偏差预警：低于预算 [ -5 ]%
成本偏差预警：超过预算 [ 5 ]%
重大偏差需要：[CFO] 审批
阈值写入各场景的 references/数据源清单.md，在 threshold: 字段下。
Part 4：写入配置
输出目标：
~/.config/finance-skills/ ← 用户配置根目录（与 Legal 一致）
├── CLAUDE.md ← 公司级配置
├── credentials/ ← API 密钥（不暴露给 Agent）
│ ├── sap.env
│ ├── pbi.env
│ └── bl.env
├── audit.log ← 操作日志
└── projects/ ← 项目空间
└── README.md
更新 references/数据源清单.md 中的 Connector 映射，注入已检测到的系统连接状态。
--check-connections 标志
只运行 Part 0（连接器检测），更新 CLAUDE.md 中的连接器状态表，不修改其他配置。
/finance:cold-start --check-connections
--redo 标志
重置所有配置，重新运行完整流程。会覆盖已有配置。
/finance:cold-start --redo
依赖关系
此 Skill 依赖：
CONNECTORS.md（第 0 部分连接器检测需要知道有哪些 Connector 可用）PROJECT_WORKSPACE.md（了解项目目录结构）- 各场景的
references/数据源清单.md（写入阈值）
首次运行前检查这些文件是否存在，如不存在给出警告。
Fallback
如果无法连接到任何财务系统：
- 标记所有 Connector 为
Offline mode
- 告知用户：Skill 将在手动输入模式下运行（用户提供数据，Agent 输出判断）
- 这是可用状态，只是效率较低
