用途：该技能用于让 AI Agent 与 Harmonic 数据交互，涵盖管理 Organizations、Pipelines、Users、Goals、Filters，以及检索人物、公司、员工与保存的搜索等场景。
安装与登录：先安装 Membrane CLI，命令为 npm install -g @membranehq/cli@latest；随后执行 membrane login --tenant --clientName=<agentType> 完成登录，交互模式会打开浏览器，无头环境会打印授权 URL，用户打开并在登录后执行 membrane login complete <code>。任意命令可加 --json 获得机器可读输出，agentType 可取 claude、openclaw、codex、warp、windsurf 等。
连接：用 membrane connection ensure "https://Harmonic.ai" --json 查找或创建连接，用户在浏览器完成认证后输出连接 id；若状态为 BUILDING，可执行 npx @membranehq/cli connection get <id> --wait --json 轮询直至 READY。若为 CLIENT_ACTION_REQUIRED，按 clientAction 的 type（connect 或 provide-input）、description、uiUrl 或 agentInstructions 处理；出现 CONFIGURATION_ERROR 或 SETUP_FAILED 时查看 error 字段。
动作检索与执行：在特定连接上下文中检索动作，命令为 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json，结果含 id、name、description、inputSchema、outputSchema。执行命令为 membrane action run <actionId> --connectionId=CONNECTION_ID --json，传参可用 --input '{"key": "value"}'，结果位于响应的 output 字段。
常见动作：get-saved-search-results、get-person-by-id、search-people、get-company-employees、get-company-by-id、search-companies、list-saved-searches、search-company-by-domain。
代理请求：当动作不覆盖需求时，可用 membrane request CONNECTION_ID /path/to/endpoint 直接请求 Harmonic API，支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项，Membrane 会自动拼接基础 URL 并注入认证头、透明刷新凭证。
最佳实践与限制：优先使用 Membrane 及其预置动作以处理认证、分页与错误；先检索已有动作再自行构建；不要让用户提供 API key 或 token，应创建连接由 Membrane 服务端管理认证；资料未提供具体收费、价格、速率限制与全部动作细节。