核心用法
holded-skill 是一个用于操作 Holded ERP 系统的安全命令行工具封装器。它通过 holdedcli 二进制文件与 Holded API 交互，支持对联系人、发票、产品、CRM、项目、团队及会计模块的数据进行读取和修改操作。
标准工作流程：
1. 验证技术前提（holded help、holded auth status）
2. 发现可用操作：holded actions list --json [--filter <关键词>]
3. 检查操作详情：holded actions describe <action> --json
4. 区分读写操作：GET 为读取，POST/PUT/PATCH/DELETE 为写入
5. 执行读取或请求写入确认后执行
关键命令模式：
- 读取：
holded actions run <action> --path/--query ... --json - 写入：需先展示完整命令、变更摘要，获明确确认（
yes/confirm）后执行 - 长负载：使用
--body-file payload.json - 采购收据：强制包含
docType=purchase和"isReceipt": true
显著优点
- 结构化安全协议：强制要求写操作前用户确认，避免误操作
- 动态发现机制：通过
actions list/describe自动适配 API 变化 - 偏好结构化输出：
--json确保机器可读、便于后续处理 - 专用采购收据规则：针对西班牙/欧盟常见收据场景硬编码校验
- 清晰错误映射：
MISSING_API_KEY、ACTION_NOT_FOUND等错误有明确处置指引
潜在缺点与局限性
- 依赖外部二进制：需独立安装
holdedcli，存在版本兼容风险 - 仅覆盖 Holded 生态：无法通用于其他 ERP 系统
- 确认流程增加交互成本：高频写操作场景下用户体验受限
- 无内置数据验证：JSON body 的有效性依赖用户或外部工具预检
- 环境变量单一：主要依赖
HOLDED_API_KEY，多租户场景配置较繁琐
适合人群
- 使用 Holded ERP 的中小企业财务/运营团队
- 需要将 Holded 数据集成到自动化工作流的开发者
- 熟悉命令行、偏好精确控制 ERP 操作的技术型用户
- 在西班牙/欧盟运营、需处理采购收据（ticket de compra）合规要求的商户
常规风险
- API 密钥泄露：
HOLDED_API_KEY需妥善保管，避免提交到代码仓库 - 误删/误改数据：尽管有确认协议，社交工程或疲劳确认仍可能导致意外写入
- API 速率限制：高频操作可能触发 Holded 服务端限流
- 数据一致性窗口：并发操作下可能出现读取脏数据
- 第三方依赖风险：
holdedcli由个人开发者维护（jaumecornado），更新持续性需关注