票据专家 · 查询计数
职责边界
- 只查计数,不拉明细:本 skill 唯一用途是查询待开票任务总数(
total)。 - Agent 不直调 MCP 工具:
get_user_and_org_info/get_pending_invoice仅由scripts/query_invoice_count.py经mcp_client内部调用。
使用方式
python skills/invoice-info-fetcher/scripts/query_invoice_count.py
输出契约
标准输出为扁平 JSON:
{ "org": { "org_no": "...", "org_name": "..." }, "total": 10, "title": "待开票任务", "subtitle": "还有 10 张票据待处理, 我来协助你批量识别并提交" }
org:机构上下文(org_no/org_name),供 agent 做机构提示total:待开票任务总数(机构维度全量,跨页一致)title/subtitle:由脚本组装的展示文案(total === 0时两者留空)
错误契约
- 接口不可用(网络/鉴权/服务端错误)时,脚本打印
{"success": false, "error_code": "auth_failed|mcp_error", "message": "...", "need_refresh": true/false}并以退出码 1 结束。 need_refresh=true表示 MCP 鉴权失败(token 过期/缺失):agent 应调用get_mcp_token重新获取并落盘后重试。- 绝不降级展示假数据:接口不可用时 agent 如实告知用户,不拼装空计数/占位文案。