菜单
银行凭证要素结构化提取框架技能，支持多种凭证类型（信用证/发票/银行单据）的智能提取，自动路由到专用子技能或配置prompt。触发词：凭证提取、要素提取、字段提取、信息提取
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/openJiuwen-ai/agent-store --skill extractor-general-factor-extract-202607命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | extractor-general-factor-extract-202607 |
| description | 银行凭证要素结构化提取框架技能，支持多种凭证类型（信用证/发票/银行单据）的智能提取，自动路由到专用子技能或配置prompt。触发词：凭证提取、要素提取、字段提取、信息提取 |
| version | 1.0.0 |
扮演银行凭证要素提取专家。通过通用凭证提取框架，支持多种凭证类型（信用证、发票、银行单据等）的智能结构化提取，自动路由到专用子技能或配置 prompt，输出提取结果。
银行凭证智能提取
当用户提及或需要进行以下场景时触发：
在开始工作前，确认以下条件满足：
从凭证图片中提取结构化字段，自动路由到专用子技能（如信用证提取器）或配置 prompt，输出提取结果和路由状态。
| 属性 | 值 | | 任务类型 | 凭证要素结构化提取 | | 风险等级 | 中（提取错误影响下游审核） | | 数据依赖 | 凭证类型 + 原始图片 + VL 视觉模型 | | 决策类型 | 字段提取（非判断型） |
| 要求项 | 状态 | | 监管合规 | 符合 JR/T 0171-2020 C2 级脱敏要求 | | 免责声明 | 提取结果仅供参考，关键场景需人工验证 | | 审计日志 | 记录调用链、入参摘要、路由状态、模型版本、时间戳 | | 引用来源 | 凭证类型预定义列表 |
| 参数名 | 类型 | 必填 | 说明 | | credential_type | str | 是 | 凭证类型名称 | | images | List[str] | 是 | Base64 编码的图片列表 | | custom_prompt | str | 否 | 自定义提取 Prompt，覆盖默认配置和专用 Skill |
模型配置：vl_config、llm_config 可选传递。不传时服务端自动注入；传递时使用调用方指定的配置。
| 输出名 | 类型 | 说明 | | success | bool | 是否成功 | | data | Dict | 提取的字段数据 | | matched_status | Dict | 路由匹配状态 | | error | str | 失败时的错误信息 |
| 字段 | 类型 | 说明 | | matched_skill | bool | 是否匹配到专用子技能 | | matched_prompt | bool | 是否使用配置 prompt | | credential_type | str | 实际路由到的凭证类型 |
# Role
你是银行凭证要素提取专家
# Tool Routing 规则（按 priority）
1. 专用子技能（如 credit-letter-extractor）→ 精确提取（优先）
2. 配置 Prompt → Prompt 模板提取（次优先）
3. VL 视觉模型 + 文本 LLM → 通用提取（fallback）
# Selection 策略
- credential_type 已匹配专用Skill → 使用专用Skill提取
- credential_type 有配置Prompt → 使用配置Prompt提取
- credential_type 未匹配 → 使用通用VL+LLM提取
# Fallback
专用Skill失败 → 降级到配置Prompt
配置Prompt失败 → 降级到通用提取
通用提取失败 → 返回提取失败
| 节点 | 模块 | 任务 | 状态 | 检查点 | | N1-输入校验 | 输入模块 | 校验凭证类型和图片 | 必须 | credential_type非空 | | N2-路由匹配 | 路由模块 | 匹配专用Skill或配置Prompt | 核心 | 路由状态 | | N3-提取执行 | 提取模块 | 执行提取（Skill/Prompt/通用） | 核心 | 提取结果 | | N4-输出组装 | 输出模块 | 组装标准输出 | 必须 | JSON格式合规 |
| 错误码 | 含义 | | 1001 | 参数校验失败 | | 1005 | VL 模型调用失败 | | 1004 | Skill 调用失败 |
完整错误码列表见 CLI 文档。
{
"success": true,
"data": {"lc_number": "LC12345", ...},
"matched_status": {
"matched_skill": true,
"matched_prompt": false,
"credential_type": "信用证"
}
}
| 依赖系统 | 作用 | 必需 | | credit-letter-extractor | 信用证专用提取 | 否（按类型路由） | | VL 视觉语言模型 | 图片内容识别 | 是 | | 文本 LLM | 结构化提取 | 是 | | Python 3.8+ | 运行环境 | 是 |
| 模块名 | 类型 | 优先级 | 降级策略 | | 专用子技能 | MCP tool | P0 | 降级到配置Prompt | | 配置Prompt | MCP tool | P1 | 降级到通用提取 | | VL视觉模型+文本LLM | MCP tool | P2 | 返回提取失败 |
专用子技能失败: 降级到配置 Prompt 提取 配置 Prompt 失败: 降级到通用 VL+LLM 提取 通用提取失败: 返回提取失败错误
会话级缓存：同一凭证类型的提取配置缓存至会话结束，TTL = 会话生命周期
| 指标 | 目标 | | 提取准确率 | ≥ 90%（与人工提取对比） | | 路由命中率 | ≥ 80%（匹配到专用Skill或Prompt） | | 单次提取延迟 | ≤ 15s |
记录工具调用链、入参（凭证类型/图片数）、路由状态（matched_skill/matched_prompt）、出参摘要（提取字段数）、数据源（模型名称）、时间戳、模型版本
本提取结果由 AI Agent 自动生成，仅供参考，关键场景需人工验证。
满足以下任一条件时，结束技能执行：
输入：
{ "credential_type": "信用证", "images": ["base64_encoded_image"] }
输出：
{
"success": true,
"data": {"lc_number": "LC12345", "amount": "..."},
"matched_status": {"matched_skill": true, "matched_prompt": false, "credential_type": "信用证"}
}
from credential_extractor import extract
result = extract(
credential_type="信用证",
images=["base64_encoded_image"],
vl_config={"api_key": "your-api-key", "api_url": "...", "model": "..."}
)
credential-extractor extract \
--type 信用证 \
--images /path/to/lc.jpg \
--vl-api-key ${your-api-key} \
--vl-url ${your-base-url} \
--vl-model ${your-model-name}
result = extract(
credential_type="信用证",
images=["base64_encoded_image"],
vl_config={...},
custom_prompt="请从图像中提取以下字段：信用证号、金额、申请人..."
)