spoki-automation

spoki-automation skill 概览

spoki-automation 适合用来做什么

spoki-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP toolkit 执行 Spoki 相关操作。它面向希望让 agent 自动发现当前 Spoki tool schema、确认 Spoki 连接状态，并在不硬编码过时 API 假设的前提下执行受支持工作流自动化任务的用户。

它的核心价值不在于提供大量 prompt 模板，而在于一套稳健的工作流规范：先搜索 Rube tools，验证 spoki 连接，检查返回的 schema，然后用经过校验的输入运行选定 action。

最适合的用户与工作流

这个 spoki-automation skill 适合已经在 Claude 中使用 MCP 和 Composio/Rube 的团队，尤其适合 Spoki 已经处在消息通知、客户运营或活动流程中的场景。当你清楚自己想达成的业务结果，但需要 agent 找到正确的 Spoki tool 以及当前输入格式时，它会很有用。

典型用例包括：让 agent 查找可用的 Spoki actions，检查认证是否有效，根据结构化的客户或活动数据准备 tool call，并在执行前说明需要哪些字段。

它和普通 prompt 有什么不同

普通 prompt 可能会猜测 tool 名称或 schema。spoki-automation 会明确要求 agent 先调用 RUBE_SEARCH_TOOLS，并使用返回的 tool slugs、schemas、execution plans 和 pitfalls。这个差异很重要，因为 MCP tool 的能力边界可能变化，而过时示例是自动化失败的常见原因。

这个 skill 有意保持聚焦：它是一个面向 Spoki、具备连接感知能力的 Rube MCP 工作流，而不是独立的 Spoki SDK、CLI，也不是完整的活动管理系统。

如何使用 spoki-automation skill

spoki-automation 的安装前提

从 Composio skills repository 安装该 skill：

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

你还需要在兼容 Claude 的客户端中配置 Rube MCP。将 https://rube.app/mcp 添加为 MCP server，然后确认该 MCP 暴露了 RUBE_SEARCH_TOOLS。这个 skill 依赖 Rube，因此只安装 markdown 文件本身是不够的。

在执行真实任务前，先要求 agent 针对 toolkit spoki 调用 RUBE_MANAGE_CONNECTIONS。如果连接状态不是 ACTIVE，请完成返回的认证流程，然后重新检查状态。

你需要提供哪些输入

为了稳定地使用 spoki-automation，请向 agent 提供具体任务、目标 Spoki object 或 workflow、数据来源、约束条件，以及它是否可以执行 action，还是只能准备计划。

较弱的 prompt：

Use Spoki to automate outreach.

更好的 prompt：

Use spoki-automation to discover the current Spoki tools via Rube MCP. Check my spoki connection first. I want to prepare a workflow for sending a WhatsApp-style customer update to a provided list, but do not execute until you show me the required fields, tool slug, schema, and any missing data.

这样做能提升结果质量，因为 agent 可以把你的目标映射到当前可用 tools，追问缺失字段，并避免在完成连接和 schema 检查之前就执行操作。

安装后的推荐工作流

先从 composio-skills/spoki-automation 中的 SKILL.md 看起；这是这个 skill 暴露出来的唯一支持文件。重点阅读其中三条操作规则：必须可用 Rube MCP、Spoki 连接必须处于 active 状态，并且在开始 workflow 前必须调用 RUBE_SEARCH_TOOLS。

一个实用的执行顺序是：

1. 让 agent 针对你的具体 Spoki 任务搜索 tools。
2. 查看返回的 tool slugs、schemas 和 warnings。
3. 要求它通过 RUBE_MANAGE_CONNECTIONS 检查 spoki。
4. 以结构化格式提供必需的业务数据。
5. 如果 action 会影响客户，请在执行前先要求 dry-run plan。

实用的 prompt 写法

可以使用这样的 prompt 格式：

Use the spoki-automation skill.

Goal: [specific Spoki outcome]
Execution mode: [plan only / execute after confirmation]
Data available: [fields, list source, IDs, message content, timing]
Constraints: [do not send duplicates, require approval, language, segment]
First steps: call RUBE_SEARCH_TOOLS for this exact use case, then check the spoki connection.
Output: show selected tool slug, required schema fields, missing inputs, and proposed execution steps.

这能让 agent 始终围绕发现和校验来推进，而不是猜测某个 Spoki API 的结构。

spoki-automation skill 常见问题

spoki-automation 对新手友好吗？

如果你的 MCP 客户端已经配置好，它对新手是友好的；但它不是一个一键式 Spoki 自动化应用。你需要能够授权 tool access、完成连接流程，并在执行前审查拟议的 tool calls。新手建议先使用 “plan only” 模式。

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

如果你需要离线 Spoki 文档、不经过 Rube MCP 的直接 API 编码帮助，或希望在 tool discovery 之前就保证某个特定 action 一定可用，就不应使用 spoki-automation。这个 skill 自身的指导依赖实时 Rube schemas，因此可用能力是在运行时确定的。

为什么这个 skill 要求先做 tool discovery？

该 repository 强调 RUBE_SEARCH_TOOLS，是因为 Composio tool schemas 可能会变化。先搜索可以让 agent 获取当前 tool 名称、必填字段、推荐计划和已知风险点。这是避免自动化失败或不安全执行的主要保护措施。

没有 Spoki 连接也能用吗？

不能。这个 skill 可以帮助检查连接状态，但实际 Spoki 操作需要通过 RUBE_MANAGE_CONNECTIONS 建立 active 的 spoki 连接。如果认证尚未完成，正确的下一步是按照返回的 auth link 完成认证，而不是继续反复提示模型。

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

通过更清晰的任务描述提升 spoki-automation 结果

最大的质量提升来自于把模糊的自动化请求改写成可执行的操作简报。请包含受众、消息或 object 类型、数据来源、所需审批、执行时间以及成功标准。如果任务可能联系客户，请明确要求发送前必须确认。

改进示例：

Before executing, summarize the exact records affected, the Spoki tool slug, required fields, and any defaults you will apply. Stop if any recipient identifier is missing.

避免常见失败模式

常见阻碍包括 Spoki 认证未激活、缺少收件人或 object 标识符、执行权限表述不清，以及凭记忆假设 tool schema。解决方式是流程化处理：搜索 tools，检查连接，校验必填字段，然后只在用户确认计划后执行。

如果 agent 跳过 discovery，可以这样纠正：

Do not infer the schema. Call RUBE_SEARCH_TOOLS for this Spoki use case and base the next step only on the returned schema.

基于第一次输出继续迭代

拿到第一版计划后，不要立刻批准执行，先要求做一次缺口检查。实用的追问包括：

• “Which required fields are still missing?”
• “What records will be affected?”
• “What could cause duplicate or unintended sends?”
• “Show the final tool call inputs before execution.”

这样可以把 spoki-automation 指南从一个简单连接器，变成更安全的工作流自动化审查闭环。

值得补充的 repository 改进项

如果上游 skill 能加入常见 Spoki 用例示例、dry-run prompt 模板，以及 Rube 或 Spoki 连接未激活时的排障说明，会更完整。再增加一个包含设置截图或特定客户端 MCP 配置说明的小型 README.md，也能降低新用户的采用门槛。