核心用法
holded-skill 是一个用于操作 Holded ERP 系统的技能，通过 holdedcli 命令行工具实现数据的读取和修改。该技能采用严格的工作流程确保操作安全性和可重复性。
操作流程
1. 技术预检：验证 holded 二进制文件和 API 密钥配置
2. 动作发现：使用 holded actions list --json 浏览可用操作
3. 参数验证：通过 holded actions describe <action> --json 检查必需/可选参数
4. 读写分类：GET/HEAD 为读取操作；POST/PUT/PATCH/DELETE 为写入操作
5. 执行与反馈：读取操作直接执行；写入操作需用户明确确认后执行
显著优点
- 动态发现机制：无需硬编码 API 端点，通过
actions list/describe自适应 Holded API 变化 - 结构化输出支持：全程使用
--json标志，便于程序化处理 - 严格的写入保护：强制确认协议、命令复述机制、模糊回复拦截
- 西班牙会计规则内置：自动校验费用可抵扣性、IVA 抵扣规则，避免常见错误（如餐厅费用误设 21% IVA）
- 特殊场景处理：购买收据需使用
--skip-validation绕过 schema 校验，支持isReceipt字段
潜在缺点与局限性
- 地域限制：会计规则针对西班牙税法设计，其他地区适用性有限
- 时区硬性要求：时间戳必须为 Europe/Madrid 时区的 Unix 秒级时间戳
- CLI 依赖：必须预先安装
holdedcli工具并通过 Homebrew 或手动部署 - API 密钥管理：需妥善保管
HOLDED_API_KEY，泄露将导致完整 ERP 数据访问权限
适合人群
- 西班牙中小企业的财务/会计人员
- 需要将 Holded ERP 集成到自动化工作流的技术团队
- 熟悉命令行操作、具备基础 JSON 知识的用户
常规风险
- 数据误删风险：虽然有多层确认，但写入操作仍可能导致不可逆变更
- 税务合规风险：尽管内置规则，最终税务责任仍由用户承担
- API 限流：高频操作可能触发 Holded API 速率限制
- 时区计算错误：手动计算时间戳易出错，建议使用提供的 Python 模板