acculynx-automation

acculynx-automation skill 概览

acculynx-automation 适合做什么

acculynx-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化处理 Acculynx 工作。它不是独立的 Acculynx API wrapper；它会引导 agent 先用 RUBE_SEARCH_TOOLS 发现当前可用的 Acculynx tool schemas，再用 RUBE_MANAGE_CONNECTIONS 确认 Acculynx 连接处于活跃状态，然后针对用户请求的工作流执行合适的 Rube MCP tools。

当你希望 AI agent 通过 Composio toolkit 处理 Acculynx 操作，同时减少 schema 猜测和过期工具导致的错误时，就适合使用这个 skill。

最适合的用户与工作流

acculynx-automation skill 更适合已经在使用 Claude 或其他支持 MCP 的客户端，并且需要可重复执行 Acculynx 任务的团队。典型场景包括 roofing、construction、CRM 或运营团队，希望自动化结构化的 Acculynx 操作，例如查询记录、准备工作流步骤，或通过 Rube 协调 tool calls。

当可用的 Acculynx 动作可能发生变化时，它尤其有用，因为这个 skill 的核心做法是先搜索 tools，而不是假设参数固定不变。

关键差异：先发现 schema

它最核心的实用价值在于强制执行 discovery pattern。agent 在执行操作前，应针对用户的具体 Acculynx 用例调用 RUBE_SEARCH_TOOLS。该调用会返回可用的 tool slugs、input schemas、建议的执行计划以及注意事项。相比只让模型“使用 Acculynx”的普通 prompt，acculynx-automation 更可靠，因为它把执行过程锚定在实时的 Rube MCP tool catalog 上。

安装前需要先确认的条件

在安装或依赖 acculynx-automation 做 Workflow Automation 之前，先确认三件事：你的客户端支持 MCP；Rube MCP 已配置为 https://rube.app/mcp；并且你的 Acculynx 连接可以通过 RUBE_MANAGE_CONNECTIONS、使用 toolkit acculynx 变为 ACTIVE。如果缺少其中任何一项，这个 skill 仍然可以描述工作流，但无法真正执行 Acculynx 操作。

如何使用 acculynx-automation skill

acculynx-automation 的安装上下文

使用你的 skill manager 从 Composio skill collection 安装该 skill，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill acculynx-automation

然后在支持 MCP 的客户端中添加 server endpoint，配置 Rube MCP：

https://rube.app/mcp

上游 skill 不包含 helper scripts 或额外参考文件，因此最重要的源码文件是 composio-skills/acculynx-automation/SKILL.md。该文件定义了必需的 MCP dependency、连接工作流，以及“先搜索 tools”的规则。

你需要提供给 skill 的输入

要让 acculynx-automation 发挥更高质量的效果，不要只给 agent 一个笼统命令。请提供业务任务、目标 Acculynx 对象或工作流区域、已知 identifiers、约束条件，以及 agent 是只需要规划还是要实际执行。

较弱的 prompt：“Update Acculynx.”

更好的 prompt：“Use acculynx-automation to find the current Acculynx tools for updating a job record. First confirm the acculynx connection is ACTIVE. Then identify the required schema for updating job status. Do not execute the update until you show me the required fields and ask for confirmation.”

这样效果更好，因为它明确告诉 skill：tool discovery 应该搜索什么、执行时要有多谨慎，以及必须遵守什么确认边界。

首次运行的推荐流程

首次运行时，先检查连接，而不是直接执行具体业务动作。让 agent 确认 RUBE_SEARCH_TOOLS 可用，然后使用 toolkit acculynx 调用 RUBE_MANAGE_CONNECTIONS。如果连接不是 active，请按照返回的 authorization link 完成授权，然后重新运行检查。

之后再针对准确的待办任务进行 discovery，例如 “search Acculynx customers”、“retrieve project details” 或 “prepare an Acculynx update workflow”。agent 应在适当情况下复用返回的 session ID，检查 tool schemas，然后再调用执行 tools。

实用 prompt 模式

一个可靠的 acculynx-automation 引导 prompt 可以这样写：

• “Search Rube tools for this exact Acculynx task: [task].”
• “Check whether the acculynx toolkit connection is ACTIVE.”
• “Show the tool slug, required inputs, optional inputs, and any pitfalls.”
• “If execution is safe, perform [action]; otherwise ask me for missing fields.”
• “Do not invent field names; use the schema returned by RUBE_SEARCH_TOOLS.”

这种模式能减少两个最常见的失败点：认证尚未就绪就开始执行，以及凭空编造 Acculynx tool 参数。

acculynx-automation skill 常见问题

没有 Rube MCP，acculynx-automation 还能用吗？

不能。这个 skill 依赖 Rube MCP 和 Composio Acculynx toolkit。如果没有 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS，它就只是一个说明文档。只有当你的环境能把 Rube MCP tools 暴露给 agent 时，才建议安装它。

它比普通的 Acculynx prompt 好在哪里？

普通 prompt 可能依赖模型对 API 或集成方式的记忆。acculynx-automation skill 会要求 agent 先发现实时 tool schemas，检查连接是否 active，并通过 Rube MCP 执行。这对 Acculynx automation 很重要，因为 tool 名称、必填字段和 auth state 都是实际运行中的细节，而通用 prompt 经常会漏掉这些信息。

初学者适合使用吗？

适合，前提是初学者能完成 MCP server 设置，并按照 authentication link 完成授权。这个 skill 的工作流并不复杂，但它默认用户理解 tool calls 可能会影响真实的 Acculynx 数据。新用户应从只读或先确认模式开始：先发现 tools，检查 schemas，并在写入变更前请求确认。

什么时候不应该使用这个 skill？

如果你只需要离线文档、直接进行自定义 API 开发、执行 Composio toolkit 之外不支持的 Acculynx 动作，或者想要完全无需审核的自动写入，就不应该使用 acculynx-automation。如果你的组织无法通过 Rube MCP 授权 Acculynx 访问，它也不适合。

如何改进 acculynx-automation skill 的使用效果

用更清晰的任务范围提升 acculynx-automation 结果

这个 skill 在用例明确时表现最好。把 “manage a claim” 改成 “discover tools for retrieving an Acculynx job by ID and checking its current status”。把 “sync customers” 改成 “find whether Acculynx tools can search customers by email and return customer IDs”。越具体的用例，越能得到更好的 RUBE_SEARCH_TOOLS 结果和更清晰的执行计划。

为写入操作添加确认规则

为了更安全地做 workflow automation，应明确区分 discovery、planning 和 execution。告诉 agent 哪些动作必须先获得批准，例如创建记录、更新 job status、修改 contacts，或把数据发送到另一个系统。一个实用规则是：“Read operations may run after schema discovery; write operations require a summary of intended changes and my approval.”

留意常见失败模式

最常见的问题包括 Acculynx 连接未激活、跳过 tool discovery、编造 schema fields，以及 prompt 范围过宽。如果输出看起来不确定，请让 agent 用更窄的用例重新运行 RUBE_SEARCH_TOOLS，并在继续前引用返回 schema 中的必填字段。

根据首次输出继续迭代

第一次运行 acculynx-automation 后，用 agent 学到的信息改进 prompt：tool slug、必需 identifiers、缺失字段，以及返回的注意事项。对于重复性工作流，可以保存一个可复用的 prompt template，包含连接检查、schema discovery、确认边界和预期输出格式。这样可以把这个 skill 从一次性的自动化助手，逐步变成更可靠的 Acculynx 操作流程。