my-invoice-skill/                # 技能根目录├── SKILL.md                     # 【必需】核心定义文件├── scripts/                     # 【可选】可执行脚本│   └── extract_invoice.py├── references/                  # 【可选】参考文档│   └── field_mapping.md└── assets/                      # 【可选】静态资源    └── output_template.xlsx

---name: invoice-extractor              # 必需：技能唯一标识（小写字母+连字符，最长64字符）description: 从 PDF 发票中提取关键字段。当用户需要“解析发票”或“提取账单信息”时使用。license: MIT                         # 可选：许可证声明compatibility: 需要 python3 及 PyPDF2  # 可选：运行环境要求allowed-tools: Bash(python:*)       # 可选：授权使用的工具---

---name: invoice-extractordescription: 从 PDF 发票中提取关键字段（发票号、日期、金额、销售方等）。当用户需要“解析发票”、“提取发票信息”或“识别 PDF 中的账单数据”时使用。compatibility: 需要 python3 及依赖库 PyPDF2、pdfplumberallowed-tools: Bash(python:*)---# 发票信息提取技能## 角色你是一名专门处理财务文档的数据提取助手。你的任务是调用指定的 Python 脚本，从用户提供的发票 PDF 中提取结构化数据。## 核心流程1. **确认文件路径**：获取用户要处理的 PDF 文件路径。2. **执行提取脚本**：运行以下命令调用核心逻辑。   ```bash   python scripts/extract_invoice.py --pdf <用户提供的文件路径> --output invoice_result.json

### 2. scripts/extract_invoice.py脚本需要遵循**标准化接口**和**结构化输出**的规范，这样才能被 AI 可靠地调用：```python#!/usr/bin/env python3# scripts/extract_invoice.pyimport argparseimport jsonimport sysimport osdef main():    parser = argparse.ArgumentParser(description="提取 PDF 发票信息")    parser.add_argument("--pdf", required=True, help="发票 PDF 文件路径")    parser.add_argument("--output", default="invoice_result.json", help="输出 JSON 文件路径")    args = parser.parse_args()    # 检查输入文件是否存在    if not os.path.exists(args.pdf):        result = {"success": False, "error": f"文件不存在：{args.pdf}"}        with open(args.output, "w", encoding="utf-8") as f:            json.dump(result, f, ensure_ascii=False, indent=2)        print(json.dumps(result, ensure_ascii=False))        sys.exit(1)    # ========== 在这里调用你的实际提取逻辑 ==========    # 以下为模拟数据，请替换为真实的 PDF 解析代码    try:        extracted_data = {            "发票号码": "24332000000123456789",            "开票日期": "2024-03-10",            "价税合计": "3,580.00",            "销售方名称": "晨光文具股份有限公司",            "购买方名称": "上海XX信息技术有限公司"        }        result = {"success": True, "data": extracted_data}    except Exception as e:        result = {"success": False, "error": f"解析失败：{str(e)}"}    # =============================================    # 输出结果到 JSON 文件    with open(args.output, "w", encoding="utf-8") as f:        json.dump(result, f, ensure_ascii=False, indent=2)    # 同时向 stdout 打印结果，方便 AI 直接读取    print(json.dumps(result, ensure_ascii=False))if __name__ == "__main__":    main()

.claude/skills/├── invoice-extractor/│   ├── SKILL.md│   └── scripts/│       └── extract_invoice.py└── another-skill/    └── SKILL.md