核心功能
holded-skill 是一个用于操作 Holded ERP 系统的终端技能，通过 holdedcli 工具实现对 Holded 平台各类实体（联系人、发票、产品、CRM、项目、团队、会计等）的安全读写访问。该技能采用结构化工作流，区分读取与写入操作，并对所有修改类操作实施强制性人工确认，有效降低误操作风险。
显著优点
- 安全优先设计：内置严格的安全协议，所有 POST/PUT/PATCH/DELETE 操作必须获得用户明确确认（"yes" 或 "confirm"），避免模糊指令导致的数据变更
- 结构化输出支持：全程使用
--json参数获取机器可读的响应，便于后续自动化处理和错误追踪 - 动态动作发现：通过
holded actions list实时查询可用 API 端点，无需硬编码接口信息 - 灵活的身份验证：支持
HOLDED_API_KEY环境变量或holded auth set交互式配置 - 完善的错误处理：针对 MISSING_API_KEY、ACTION_NOT_FOUND、INVALID_BODY、API_ERROR 等常见错误提供明确的排查指引
潜在局限
- 依赖外部二进制：必须预先安装
holdedcli，且仅支持通过 Homebrew 分发（jaumecornado/tap/holded） - 仅支持 Holded 生态：功能完全限定于 Holded ERP 平台，不具备跨平台通用性
- 确认流程增加交互成本：高频批量写操作场景下，逐条确认可能影响效率
- API 能力受限于 Holded 官方：无法访问 Holded 未开放的端点或数据类型
适合人群
- 需要自动化 Holded 数据管理的中小企业财务/运营团队
- 开发集成 Holded ERP 的 DevOps 工程师
- 使用 Holded 进行项目管理和客户关系管理的技术型用户
常规风险
- 数据修改不可逆：尽管有确认机制，一旦执行写操作，Holded API 层面的删除或更新通常无法回滚
- API 密钥泄露风险：
HOLDED_API_KEY若被泄露，可能导致企业核心财务数据暴露 - JSON 格式错误导致失败：
--body或--body-file参数若包含语法错误，操作将中断 - 网络依赖：所有操作需实时连接 Holded 云服务，离线场景不可用