givebutter-automation

givebutter-automation skill 概览

givebutter-automation 适合用来做什么

givebutter-automation skill 可帮助 AI agent 通过 Composio 的 Rube MCP 接口自动执行 Givebutter 任务。它适合这样的工作流：agent 需要先发现当前可用的 Givebutter 工具 schema，确认连接已完成认证，然后再使用正确的 Rube tool calls 执行操作，而不是凭记忆猜测 API 字段。

最适合的用户和工作流

这个 skill 适合已经在使用 Givebutter，并希望让 Claude 或其他支持 MCP 的 agent 协助处理运营任务的非营利组织运营人员、活动团队、筹款管理员和自动化搭建者。典型场景包括 donor、campaign、transaction、contact、event 或 reporting 相关工作流；这些场景中，应该通过 RUBE_SEARCH_TOOLS 在运行时发现准确可用的操作。

它和普通 prompt 有什么不同

普通 prompt 可能只是要求 agent “更新 Givebutter”或“拉取 donor 数据”，但不会强制执行 schema discovery 或连接校验。givebutter-automation skill 增加了一套更安全的执行模式：先搜索工具，检查 Givebutter 连接，使用返回的 schema，通过 Rube MCP 执行，并验证结果。这样做很重要，因为 Composio 的 tool 名称、字段和支持的操作可能会变化。

主要采用限制

这个 skill 依赖 Rube MCP 和一个有效的 Givebutter 连接。它不是独立的 Givebutter API wrapper，也不包含辅助脚本、本地资源或单独的 README。安装前，请确认你的 AI client 支持 MCP servers，并且可以访问 https://rube.app/mcp。

如何使用 givebutter-automation skill

givebutter-automation 的安装前提

如果你的 client 支持 skill 安装，可以从 Composio skills repository 安装：

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

然后在 client 配置中将 Rube MCP 添加为 MCP server：

https://rube.app/mcp

该 repository 的 SKILL.md 不提供专属 runtime 或脚本。关键配置是：MCP 可用，并且通过 Rube 管理好 Givebutter 连接。

运行任务前必须完成的设置

首先确认 RUBE_SEARCH_TOOLS 可用。然后使用 RUBE_MANAGE_CONNECTIONS，并将 toolkit 设置为 givebutter，检查连接是否处于 active 状态。如果 Rube 返回认证链接，请先完成授权流程，再让 agent 修改或检索 Givebutter 数据。

一个实用的起始 prompt 是：

Use the givebutter-automation skill. First call RUBE_SEARCH_TOOLS for my Givebutter task, then check the givebutter connection with RUBE_MANAGE_CONNECTIONS. Do not execute changes until you show me the discovered tool, required fields, and planned action.

把模糊目标改写成高质量 prompt

较弱的 prompt：

Update my Givebutter donors.

更好的 prompt：

Use givebutter-automation for Workflow Automation. I need to find Givebutter supporters who donated to campaign [campaign name or ID] between [date range], identify records missing phone numbers, and prepare an update plan. First discover current Givebutter tools with RUBE_SEARCH_TOOLS; then confirm the Givebutter connection is active. If a write operation is needed, show the exact fields you will send before executing.

更清晰的输入会带来更好的输出，因为这个 skill 依赖发现到的 schema。请包含 object type、campaign 或 event identifiers、date range、期望的 read/write action、匹配规则，以及 agent 是否需要在变更前暂停等待确认。

优先查看的文件和源码路径

关键源文件是：

• composio-skills/givebutter-automation/SKILL.md

阅读它可以了解必需的工作流：prerequisites、setup、tool discovery、connection check、execution 和 result verification。这个 skill 没有捆绑脚本、references 或 rule folders，因此大部分实现细节会来自 Rube 的实时 tool discovery，以及 Composio 的 Givebutter toolkit 文档。

givebutter-automation skill 常见问题

givebutter-automation 对新手友好吗？

如果你已经有支持 MCP 的 AI client，并且能通过 Rube 授权 Givebutter，那么它对新手是比较友好的。如果你期待的是点按式集成，它就没那么适合，因为 agent 必须调用 MCP tools 并理解返回的 schema。新手应先从只读的 discovery 或 reporting 任务开始，再逐步允许更新操作。

它可以替代 Givebutter dashboard 吗？

不能。givebutter-automation skill 更适合可重复的运营工作流、批量辅助、报表准备和有引导的更新。对于人工复核、可视化 campaign 管理，以及需要人工直接检查记录的敏感一次性变更，Givebutter dashboard 仍然更合适。

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

当你无法连接 Rube MCP、Givebutter 账号尚未授权，或你需要在 tool discovery 之前就保证支持某个特定 Givebutter 操作时，不应使用它。对于 donor、payment、campaign 或 event 数据，也应避免无人监督的写入操作，除非你的 prompt 中包含审批关卡和验证步骤。

为什么 agent 必须先搜索工具？

上游 skill 明确要求在工作流开始前调用 RUBE_SEARCH_TOOLS。这很重要，因为当前的 tool slugs、input schemas、推荐执行计划和注意事项都是动态返回的。跳过 discovery 会增加字段无效、假设错误或自动化执行失败的风险。

如何改进 givebutter-automation skill

优化 prompt，提升 givebutter-automation 结果质量

为了更好地使用 givebutter-automation，不要只告诉 agent 最终目标，还要给出操作边界。明确任务是只读还是可以写入数据，什么算匹配，如何处理重复记录，是否需要分批变更，以及何时停下来等待批准。

示例：

Find supporters from campaign Spring Gala 2025 with donations over $250. Return a table with name, email, donation total, and missing fields. Do not update records. If an update tool exists, only describe the schema and ask before using it.

为写入工作流增加保护措施

对于更新操作，要求 agent 将 discovery、planning、execution 和 verification 分开处理。一个可靠的工作流是：发现工具，检查连接，获取目标记录，汇总拟议变更，等待批准，小批量执行，然后报告成功和失败情况。这样可以降低 donor 或 campaign 数据被意外修改的风险。

需要留意的常见失败模式

最常见的问题包括 Givebutter 授权未激活、跳过 tool discovery、object identifiers 过于模糊，以及 prompt 请求了不支持的操作。如果第一次结果失败，请让 agent 展示它使用的确切 Rube tool schema、缺少的 required fields，以及下一步最安全的替代方案。

根据第一次输出继续迭代

第一次运行后，用返回的 schema names 和 field requirements 继续细化任务。例如，把“get recent donors”改成“use the discovered donor or transaction search tool for donations after 2025-01-01, filtered by campaign ID.” 通过这种迭代方式，givebutter-automation skill 会从一个宽泛的助手，逐步变成可靠的 Givebutter 工作流执行者。