| name | fund-collection |
| description | 资金归集（仅归集 + Handoff，不含申购）：在用户已给出理财产品与购买金额时，查询理财余额； 不足则确认是否从银行卡归集、生成方案、逐笔转账确认，成功后输出 Handoff 给下游购买 Skill。 Use whenever the user mentions 资金归集、从银行卡归集/转钱到理财、买/申购某理财产品且余额可能不足、 购买金额不足需改金额、或上游已带齐 productId+amount 需要先归集再购买。 Also trigger on phrases like「买一万天天红」「帮我归集后再买」「可用资金不够改一下金额」。 Do NOT use for product recommendation alone, chat unrelated to purchase/collection, or executing 理财申购 itself. |
| compatibility | Agent must have readFile; account/query/transfer via host Java VersatileClient (or equivalent HTTP) and HITL Workflow Runner (interact / INPUT_REQUIRED). |
| metadata | {"author":"finance-solution","version":"2.0.0","schema_version":"1.0","domain":"cash-management"} |
资金归集
Overview
本 Skill 只做资金归集：把银行卡资金汇总到理财账户，达到目标购买金额后输出 Handoff。
不做理财产品推荐、不执行申购。
确定性步骤（余额比较、方案生成、转账、终态判定）禁止 LLM 编造；须走宿主 VersatileClient / 等价指令，或完整包内确定性 scripts/runtime。
Instructions
1. 进入条件
同时具备（或槽位累积后齐备）：
- 合法
amount（产品起购～上限）
- 可识别的产品（
productId 或产品名）
- 明确的购买/归集意图，或上游已传入上述字段
信息不全 → 追问（REPLY_ONLY），不要启动归集工作流。
闲聊 / 无此产品 / 金额非法 → 使用 resources/contracts/fixed-phrases.md 固定话术。
2. 工作流（按序执行）
GET_MYCARD_NO → GET_ACCOUNT_BALANCE(WEALTH) 查理财余额- 余额充足 →
COLLECTION_SUCCESS + Handoff（无 HITL）
- 不足 → HITL
COLLECTION_PROMPT（是否从银行卡归集）
- 用户确认 →
GET_MYALLCARD_INFO + 逐卡 GET_ACCOUNT_BALANCE
- 可用资金总额仍不足 → HITL
AMOUNT_ADJUSTMENT（最多改购买金额 2 次；非法输入不扣次数）
- 可归集 → HITL
PLAN（≤3 个方案，推荐最少笔数）；no → COLLECTION_CANCELLED
- 逐笔 HITL
TRANSFER → QUICK_TRANSFER；多笔拒绝且仍缺 → TRANSFER_RECOVERY
- 达标 →
COLLECTION_SUCCESS + Handoff；否则 COLLECTION_FAILED
分支与终态细则：按需读取 resources/contracts/workflow-branches.md。
3. HITL（5 类 confirmType）
| confirmType | 用户确认什么 |
|---|
COLLECTION_PROMPT | 是否从银行卡归集 |
AMOUNT_ADJUSTMENT | 新的购买金额（或取消） |
PLAN | 归集方案 / 暂不归集 |
TRANSFER | 本笔转账 |
TRANSFER_RECOVERY | 更改方案 / 彻底取消 |
内核语义：interact → INPUT_REQUIRED → 按 nodeId 恢复。细节按需读：
resources/contracts/hitl-confirmations.mdresources/contracts/openjiuwen-interaction.md
4. 账户指令
| 步骤 | command |
|---|
| 理财尾号 → 全卡号 | GET_MYCARD_NO |
| 名下银行卡 | GET_MYALLCARD_INFO |
| 查余额 | GET_ACCOUNT_BALANCE |
| 转账 | QUICK_TRANSFER |
映射与归一化：按需读 resources/contracts/command-codes.md；响应归一化脚本 scripts/normalize_result.py。
禁止使用 PURCHASEINVEST（申购属下游）。
展示层金额统一 xxxx.xx元；page card 勿下发完整卡号，仅 maskedNumber。
5. Handoff（仅 COLLECTION_SUCCESS）
{
"userId": "U10001",
"productId": "TT_HONG",
"targetAmount": "10000.00元",
"collectionSuccess": true,
"finalWealthBalance": "10000.00元",
"conversationId": "..."
}
Schema：resources/schemas/collection-output-schema-v1.json。
6. LLM 边界
| 允许 | 禁止 |
|---|
| 意图识别、槽位追问 reply | 余额比较、方案排序、转账执行、编造 Handoff |
Progressive disclosure（按需读取）
不要一次读完所有契约。 需要细节时再用 readFile：
| 时机 | 文件 |
|---|
| 契约索引 | resources/contracts/README.md |
| 分支 / 终态 | resources/contracts/workflow-branches.md、resources/schemas/terminal-states.json |
| HITL 载荷 | resources/contracts/hitl-confirmations.md |
| 固定话术 | resources/contracts/fixed-phrases.md |
| 指令码 | resources/contracts/command-codes.md |
| 回执 JSON | resources/contracts/response-formats.md |
| 入参 Schema | resources/schemas/collection-input-schema-v1.json |
| 示例 I/O | examples/ |
打包、安装、pytest、CLI 属人类运维/QA文档，见根目录 资金归集Skill测试和部署指导文档v2.0.md 与 README.md。Agent 执行归集时不必加载这些文档。
Related skills
| Skill | 关系 |
|---|
wealth-product-recommendation | 上游可选：推荐产品 |
| 下游购买 Skill | 接收本 Skill 的 Handoff 并执行申购 |
