gosquared-automation

gosquared-automation skill 概览

gosquared-automation 适合做什么

gosquared-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行与 GoSquared 相关的工作流。它不会把某一种 GoSquared API 结构硬编码进去，而是要求智能体先发现当前可用的 Rube tools，再根据返回的 schemas 执行正确的 GoSquared 操作。

当你希望 AI 智能体协助完成 GoSquared workflow automation、连接检查、tool discovery 和任务执行，同时又不想每次都手动翻阅 Composio toolkit 文档时，可以使用 gosquared-automation skill。

最适合的用户和任务

gosquared-automation skill 最适合已经在使用 GoSquared，并希望 Claude 通过 MCP 工具层来操作的用户。它适用于负责 analytics、访客/客户活动、engagement 工作流或运营任务的团队，尤其是当具体的 GoSquared tool schema 可能发生变化时。

如果你的工作流通常从业务需求开始，例如“检查最近的访客活动”或“运行这个 GoSquared 操作”，并且需要把它转换成有效的 Rube MCP tool call，这个 skill 会特别有用。

主要差异点

它最重要的差异点是“先搜索 tools”的模式。该 skill 不假设 GoSquared tool 列表是固定的。它要求在执行前先调用 RUBE_SEARCH_TOOLS，这样 Claude 才能获取当前的 tool slugs、input schemas、recommended plans 和 pitfalls。

这让 gosquared-automation 比静态 prompt 更稳健，但也意味着采用它的前提是你已经连接了 Rube MCP，并且 GoSquared connection 处于可用状态。

如何使用 gosquared-automation skill

gosquared-automation 安装上下文

如果你的客户端支持安装 Claude skill，可以从 Composio skills collection 安装：

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

然后在客户端配置中将 Rube MCP 添加为 MCP server：

https://rube.app/mcp

该 skill 依赖 rube MCP server。在期待任何 GoSquared 自动化正常工作之前，先确认 RUBE_SEARCH_TOOLS 可用。然后使用 RUBE_MANAGE_CONNECTIONS，toolkit 设为 gosquared；如果 connection 不是 ACTIVE，按照返回的授权流程完成连接。

skill 需要哪些输入

像“use GoSquared”这样笼统的请求会留下太多猜测空间。建议给智能体提供：

• 你希望完成的 GoSquared 任务；
• 涉及的对象或活动类型（如果知道）；
• 日期范围、筛选条件、IDs、邮箱地址、项目/站点上下文或 segment 名称；
• 智能体是只需要规划、检索数据，还是可以做修改；
• 对破坏性操作或面向客户的更新有哪些限制。

更好的 prompt 示例：

“Use the gosquared-automation skill. First search Rube tools for the current GoSquared schema. Check that the gosquared connection is active. I want to retrieve visitor or customer activity for the last 7 days for our production project. Do not modify records. Show the tool you plan to call, required fields, and any missing information before executing.”

推荐工作流

先阅读 composio-skills/gosquared-automation 中的 SKILL.md；它包含完整的运行模式，以及必需的 Rube MCP 依赖。这个 skill 没有额外的 rules/、resources/、references/ 或辅助脚本，因此这个单一文件就是事实来源。

实际使用时，可以要求 Claude 按以下顺序执行：

1. 针对具体的 GoSquared 使用场景调用 RUBE_SEARCH_TOOLS。
2. 检查返回的 tool names、schemas 和 pitfalls。
3. 通过 RUBE_MANAGE_CONNECTIONS 确认 GoSquared connection。
4. 执行前先询问缺失的必填字段。
5. 只有在 schema 和 connection 都验证通过后才执行。

实用 prompt 模式

当你能描述目标结果，但不确定具体 API call 时，就适合使用该 skill。例如：

“Use gosquared-automation for Workflow Automation. Search tools for ‘GoSquared customer lookup and recent activity’. If multiple tools match, compare them briefly and choose the safest read-only option. If auth is inactive, stop and give me the connection step. If required fields are missing, ask me instead of guessing.”

这个 prompt 更有效，因为它明确了使用场景、安全边界、发现行为和决策规则。

gosquared-automation skill 常见问题

没有 Rube MCP，gosquared-automation 够用吗？

不够。该 skill 依赖 Rube MCP 和 Composio GoSquared toolkit。如果 RUBE_SEARCH_TOOLS 不可用，Claude 就无法遵循预期的“先发现、后执行”工作流。如果 gosquared connection 未激活，智能体也许可以做规划，但不应执行 GoSquared 操作。

它比普通 prompt 好在哪里？

普通 prompt 可能会编造 tool names，或依赖过时的 GoSquared 假设。gosquared-automation skill 会明确指示智能体在行动前先搜索当前 schemas。对于基于 MCP 的自动化来说，这很有价值，因为 tool names、必填字段和执行指引都可能变化。

适合新手吗？

如果你的客户端已经支持 MCP servers 和 Claude skills，它对新手是友好的。但它不是一份一键式 GoSquared 设置指南。新手需要预期自己要配置 Rube MCP endpoint、授权 GoSquared connection，并在运行工作流前提供清晰的任务细节。

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

如果你需要的是直接的 GoSquared API 代码、离线文档，或绕过 Composio/Rube 的自动化，就不要使用它。对于可能在未经审查的情况下修改客户数据的模糊请求，也应避免使用。对于写入操作，应要求智能体在执行前展示所选 tool、字段和预期影响。

如何改进 gosquared-automation skill

让 gosquared-automation prompts 更具体

最大的质量提升来自于用可执行的业务上下文替代宽泛目标。不要只说“automate GoSquared reporting”，而要说明指标、时间窗口、受众、项目、输出格式，以及结果是否只读。

更好的输入：

“Find the current Rube tools for GoSquared analytics retrieval. I need a summary for the previous calendar week, grouped by day if supported. Return a table and do not create or update anything.”

这样可以减少 schema 不匹配，并帮助智能体选择风险最低的 tool。

避免常见失败模式

常见失败包括跳过 tool discovery、假设 connection 已激活、猜测必填字段，或在只读 tool 足够时使用具备写入能力的 tool。应明确要求智能体在缺少必填输入时停止，并且除非你明确批准 mutation，否则优先使用只读调用。

对于敏感工作流，可以加上：“Before any write action, summarize the exact tool call and wait for confirmation.”

根据第一次输出继续迭代

第一次运行后，用具体反馈继续细化：缺少筛选条件、日期范围错误、原始数据过多，或需要不同的分组方式。由于 gosquared-automation 依赖实时 tool discovery，迭代时应引用已发现的 tool schema，而不是泛泛地使用 GoSquared 术语。

后续追问示例：

“Use the same discovered tool if appropriate, but narrow the result to visitors from paid campaigns and return only fields needed for a weekly operations report.”

如果 fork 了源码，如何改进 skill

如果你维护自己的 fork，有价值的改进包括：为常见 GoSquared 任务添加示例 prompts，明确区分只读与写入工作流模式，并加入一小段针对 inactive connections 的排障说明。请保持“先发现”的规则足够醒目；这是让 gosquared-automation 可靠的核心行为。