Agentic Awesome Skills 实战:基于 Rube MCP(Composio)的 Basecamp 全流程自动化 Skill 指南
Agentic Awesome Skills 实战:基于 Rube MCP(Composio)的 Basecamp 全流程自动化 Skill 指南
本文以 plugins/agentic-awesome-skills-claude/skills/basecamp-automation/SKILL.md 为骨架,讲解如何通过 Rube MCP(Composio 的 Basecamp toolkit)在 Agent 环境中自动化 Basecamp 的项目管理、待办清单、消息板、人员访问与待办分组等核心操作。读完本文,你将掌握该 Skill 的完整接入流程、五大核心工作流的标准工具调用序列、关键参数语义与常见坑点规避方法,并能直接落地为可复用的自动化流程。
一、Skill 定位与适用场景
basecamp-automation 是 AAS(Agentic Awesome Skills)技能库中面向 Basecamp 协作平台的一站式自动化 Skill。它并不直接封装 Basecamp REST API,而是以 Rube MCP(Composio) 作为执行通道:Agent 通过 Rube 暴露的 RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS 等 MCP 工具发现 schema、建立 OAuth 连接,再调用形如 BASECAMP_GET_PROJECTS、BASECAMP_CREATE_MESSAGE 的 Basecamp 工具完成实际操作。
从仓库元数据看,该 Skill 已正式登记在册:data/catalog.json 与 data/skills_index.json 中均收录了 basecamp-automation 条目及其 basecamp-automation/SKILL.md 路径,data/bundles.json 中也存在对应引用,说明它是经过目录登记的社区技能(source: community,risk 等级为 critical,即涉及账号级写操作,需谨慎使用)。
适用场景:用户需要创建待办清单与任务、向项目消息板发布或更新消息、管理项目成员与访问权限、用颜色分组组织待办、或浏览项目结构时,均可触发本 Skill。它只应在任务明确匹配上述范围时使用。
二、前置条件与连接设置
前置条件
- Rube MCP 必须已连接:客户端环境中存在可用的
RUBE_SEARCH_TOOLS工具,这是发现 Basecamp 工具最新 schema 的入口。 - Basecamp 连接必须 ACTIVE:通过
RUBE_MANAGE_CONNECTIONS建立 Basecamp 连接,toolkit 名称为basecamp。 - 先搜索、后调用:任何工作流开始前,先调用
RUBE_SEARCH_TOOLS获取当前工具 schema,避免因 API 演进导致参数不匹配。
接入步骤
- 添加 Rube MCP 服务器:在客户端配置中将
https://rube.app/mcp添加为 MCP server 端点。无需任何 API Key——添加端点即可工作。 - 验证连通性:确认
RUBE_SEARCH_TOOLS有响应。 - 建立 Basecamp 连接:调用
RUBE_MANAGE_CONNECTIONS,指定 toolkit 为basecamp。 - 完成 OAuth 授权:若连接状态不是 ACTIVE,跟随返回的授权链接完成 Basecamp OAuth 流程。
- 确认状态后再执行:只有连接状态显示 ACTIVE,才能开始运行任何工作流。
关键事实:整个接入过程不需要 API Key,依赖的是 Rube MCP 端点的标准 OAuth 连接机制。任何写操作(创建清单、发消息、改权限)都必须以 ACTIVE 连接为前提。
三、核心工作流一:管理待办清单与任务
何时使用:用户想要创建待办清单、添加任务,或在某个 Basecamp 项目内组织工作。
标准工具调用序列
| 步骤 | 工具 | 作用 | 必要性 |
|---|---|---|---|
| 1 | BASECAMP_GET_PROJECTS |
列出项目,定位目标 bucket_id |
前置 |
| 2 | BASECAMP_GET_BUCKETS_TODOSETS |
获取项目内的待办集合(to-do set) | 前置 |
| 3 | BASECAMP_GET_BUCKETS_TODOSETS_TODOLISTS |
列出已有待办清单,避免重复创建 | 可选 |
| 4 | BASECAMP_POST_BUCKETS_TODOSETS_TODOLISTS |
在待办集合中创建新待办清单 | 创建清单必选 |
| 5 | BASECAMP_GET_BUCKETS_TODOLISTS |
获取某个待办清单的详情 | 可选 |
| 6 | BASECAMP_POST_BUCKETS_TODOLISTS_TODOS |
在待办清单中创建待办任务 | 创建任务必选 |
| 7 | BASECAMP_CREATE_TODO |
创建单个待办的替代工具 | 替代方案 |
| 8 | BASECAMP_GET_BUCKETS_TODOLISTS_TODOS |
列出清单内的待办 | 可选 |
创建待办清单的关键参数
bucket_id:整数类型,项目/桶 ID(来自GET_PROJECTS)todoset_id:整数类型,待办集合 ID(来自GET_BUCKETS_TODOSETS)name:待办清单标题(必填)description:HTML 格式的描述(支持富文本)
创建待办任务的关键参数
bucket_id:整数类型,项目/桶 IDtodolist_id:整数类型,待办清单 IDcontent:待办事项内容(必填)description:待办的 HTML 格式详情assignee_ids:整数人员 ID 数组due_on:截止日期,格式YYYY-MM-DDstarts_on:开始日期,格式YYYY-MM-DDnotify:布尔值,是否通知被指派者(默认false)completion_subscriber_ids:任务完成时被通知的人员 ID 数组
陷阱清单
- 一个项目(bucket)可能包含多个待办集合,选错
todoset_id会把清单建到错误的区块。 - 创建前务必检查已有清单,避免产生近似重复的名称。
- 成功响应的 payload 中包含面向用户的 URL(
app_url、app_todos_url),优先返回这些 URL 而非裸 ID。 - 所有 ID(
bucket_id、todoset_id、todolist_id)都是整数,不是字符串。 - 描述只支持 HTML 格式化,不支持 Markdown。
四、核心工作流二:发布与管理消息
何时使用:用户想向项目消息板发布消息,或更新已有消息。
标准工具调用序列
BASECAMP_GET_PROJECTS—— 找到目标项目与bucket_id(前置)BASECAMP_GET_MESSAGE_BOARD—— 获取项目消息板 ID(前置)BASECAMP_CREATE_MESSAGE—— 在消息板上创建新消息(必选)BASECAMP_POST_BUCKETS_MESSAGE_BOARDS_MESSAGES—— 备选的消息创建工具(兜底)BASECAMP_GET_MESSAGE—— 按 ID 读取单条消息(可选)BASECAMP_PUT_BUCKETS_MESSAGES—— 更新已有消息(可选)
关键参数
bucket_id:整数类型,项目/桶 IDmessage_board_id:整数类型,消息板 ID(来自GET_MESSAGE_BOARD)subject:消息标题(必填)content:消息的 HTML 正文status:设为"active"以立即发布category_id:消息类型分类(可选)subscriptions:需要通知的人员 ID 数组;省略则通知所有项目成员
陷阱清单
status="draft"可能产生 HTTP 400,请用status="active"作为可靠选项。bucket_id与message_board_id必须属于同一个项目,不匹配会导致失败或消息被错误路由。- 消息内容只支持 HTML 标签,不支持 Markdown。
- 通过
PUT_BUCKETS_MESSAGES更新会整体替换正文——必须传入完整修正后的内容,而不是 diff。 - 用户可见的确认链接优先使用响应中的
app_url。 CREATE_MESSAGE与POST_BUCKETS_MESSAGE_BOARDS_MESSAGES功能相同:优先用CREATE_MESSAGE,失败再回退到 POST。
五、核心工作流三:管理人员与项目访问
何时使用:用户想列出人员、管理项目访问,或添加新用户。
标准工具调用序列
BASECAMP_GET_PEOPLE—— 列出当前用户可见的所有人员(必选)BASECAMP_GET_PROJECTS—— 找到目标项目(前置)BASECAMP_LIST_PROJECT_PEOPLE—— 列出特定项目上的人员(必选)BASECAMP_GET_PROJECTS_PEOPLE—— 列出项目成员的替代工具(替代方案)BASECAMP_PUT_PROJECTS_PEOPLE_USERS—— 授予或撤销项目访问权限(变更访问必选)
PUT_PROJECTS_PEOPLE_USERS 关键参数
project_id:整数类型,项目 IDgrant:整数人员 ID 数组,将这些人员加入项目revoke:整数人员 ID 数组,将这些人员移出项目create:对象数组,每项包含name、email_address,可选company_name、title,用于创建新用户grant、revoke、create至少提供其一
陷阱清单
- 人员 ID 是整数;操作前务必先用
GET_PEOPLE把姓名解析为 ID。 - 人员管理语境下的
project_id与其它操作中的bucket_id是同一个实体。 LIST_PROJECT_PEOPLE与GET_PROJECTS_PEOPLE近乎等价,任选其一。- 通过
create创建用户会一步到位同时授予项目访问权限。
六、核心工作流四:用分组组织待办
何时使用:用户想把清单内的待办组织进颜色编码的分组。
标准工具调用序列
BASECAMP_GET_PROJECTS—— 找到目标项目(前置)BASECAMP_GET_BUCKETS_TODOLISTS—— 获取待办清单详情(前置)BASECAMP_GET_TODOLIST_GROUPS—— 列出清单中已有分组(可选)BASECAMP_GET_BUCKETS_TODOLISTS_GROUPS—— 列出分组的替代工具(替代方案)BASECAMP_POST_BUCKETS_TODOLISTS_GROUPS—— 在待办清单中创建新分组(必选)BASECAMP_CREATE_TODOLIST_GROUP—— 创建分组的替代工具(替代方案)
关键参数
bucket_id:整数类型,项目/桶 IDtodolist_id:整数类型,待办清单 IDname:分组标题(必填)color:视觉颜色标识,可选值为固定调色板:white、red、orange、yellow、green、blue、aqua、purple、gray、pink、brownstatus:列出的过滤条件——"archived"或"trashed"(省略则只列活跃分组)
陷阱清单
POST_BUCKETS_TODOLISTS_GROUPS与CREATE_TODOLIST_GROUP近乎等价,任选其一。- 颜色必须是固定调色板中的值;任意 hex/rgb 值不受支持。
- 分组是待办清单内的子区块,不是独立实体。
七、核心工作流五:浏览与检视项目
何时使用:用户想列出项目、获取项目详情,或探索项目结构。
标准工具调用序列
BASECAMP_GET_PROJECTS—— 列出所有活跃项目(必选)BASECAMP_GET_PROJECT—— 获取某个项目的完整详情(可选)BASECAMP_GET_PROJECTS_BY_PROJECT_ID—— 项目详情检索的替代工具(替代方案)
关键参数
status:按"archived"或"trashed"过滤;省略则列出活跃项目project_id:整数类型,用于详细检索的项目 ID
陷阱清单
- 项目按最近创建优先排序。
- 响应中包含
dock数组,内含各工具(todoset、message_board等)及其 ID。 - 使用 dock 中的工具 ID 来获取后续操作所需的
todoset_id、message_board_id等。
八、常用模式:ID 解析、分页与内容格式化
ID 解析(自顶向下)
Basecamp 采用层级化 ID 结构,务必自上而下解析:
- 项目(bucket_id):
BASECAMP_GET_PROJECTS按名称查找,捕获id - 待办集合(todoset_id):位于项目 dock 中,或经
BASECAMP_GET_BUCKETS_TODOSETS获取 - 消息板(message_board_id):位于项目 dock 中,或经
BASECAMP_GET_MESSAGE_BOARD获取 - 待办清单(todolist_id):
BASECAMP_GET_BUCKETS_TODOSETS_TODOLISTS - 人员(person_id):
BASECAMP_GET_PEOPLE或BASECAMP_LIST_PROJECT_PEOPLE - 注意:
bucket_id与project_id在不同语境下指代同一个实体
分页
Basecamp 列表端点使用基于页的分页:
- 响应头或响应体可能指示是否还有更多页。
GET_PROJECTS、GET_BUCKETS_TODOSETS_TODOLISTS等列表端点均返回分页结果。- 持续抓取直到不再返回结果为止。
内容格式化
- 所有富文本字段使用 HTML,而非 Markdown。
- 将内容包裹在
<div>标签内;可使用<strong>、<em>、<ul>、<ol>、<li>、<a>等标签。 - 示例:
<div><strong>Important:</strong> Complete by Friday</div>
九、已知坑点汇总
ID 格式
- 所有 Basecamp ID 均为整数,不是字符串或 UUID。
bucket_id=project_id(同一实体,不同工具中的参数名不同)。- 待办集合 ID、待办清单 ID、消息板 ID 均位于项目
dock数组中。 - 人员 ID 是整数;操作前先用
GET_PEOPLE解析姓名。
status 字段
- 消息的
status="draft"可能触发 HTTP 400;始终使用status="active"。 - 项目/待办清单的状态过滤:
"archived"、"trashed",或省略表示活跃。
内容格式
- 只支持 HTML,绝不使用 Markdown。
- 更新操作会整体替换正文,而非部分 diff。
- 非法 HTML 标签可能被静默剥离。
速率限制
- Basecamp API 有速率限制;应拉大快速连续请求的间隔。
- 待办数量多的大型项目应谨慎分页。
URL 处理
- 面向用户的链接优先使用 API 响应中的
app_url。 - 不要根据 ID 手工拼装 Basecamp URL。
十、快速参考表
| 任务 | 工具 | 关键参数 |
|---|---|---|
| 列出项目 | BASECAMP_GET_PROJECTS |
status |
| 获取项目 | BASECAMP_GET_PROJECT |
project_id |
| 获取项目详情 | BASECAMP_GET_PROJECTS_BY_PROJECT_ID |
project_id |
| 获取待办集合 | BASECAMP_GET_BUCKETS_TODOSETS |
bucket_id, todoset_id |
| 列出待办清单 | BASECAMP_GET_BUCKETS_TODOSETS_TODOLISTS |
bucket_id, todoset_id |
| 获取待办清单 | BASECAMP_GET_BUCKETS_TODOLISTS |
bucket_id, todolist_id |
| 创建待办清单 | BASECAMP_POST_BUCKETS_TODOSETS_TODOLISTS |
bucket_id, todoset_id, name |
| 创建待办 | BASECAMP_POST_BUCKETS_TODOLISTS_TODOS |
bucket_id, todolist_id, content |
| 创建待办(替代) | BASECAMP_CREATE_TODO |
bucket_id, todolist_id, content |
| 列出待办 | BASECAMP_GET_BUCKETS_TODOLISTS_TODOS |
bucket_id, todolist_id |
| 列出待办分组 | BASECAMP_GET_TODOLIST_GROUPS |
bucket_id, todolist_id |
| 创建待办分组 | BASECAMP_POST_BUCKETS_TODOLISTS_GROUPS |
bucket_id, todolist_id, name, color |
| 创建待办分组(替代) | BASECAMP_CREATE_TODOLIST_GROUP |
bucket_id, todolist_id, name |
| 获取消息板 | BASECAMP_GET_MESSAGE_BOARD |
bucket_id, message_board_id |
| 创建消息 | BASECAMP_CREATE_MESSAGE |
bucket_id, message_board_id, subject, status |
| 创建消息(替代) | BASECAMP_POST_BUCKETS_MESSAGE_BOARDS_MESSAGES |
bucket_id, message_board_id, subject |
| 获取消息 | BASECAMP_GET_MESSAGE |
bucket_id, message_id |
| 更新消息 | BASECAMP_PUT_BUCKETS_MESSAGES |
bucket_id, message_id |
| 列出全部人员 | BASECAMP_GET_PEOPLE |
(无) |
| 列出项目人员 | BASECAMP_LIST_PROJECT_PEOPLE |
project_id |
| 管理访问权限 | BASECAMP_PUT_PROJECTS_PEOPLE_USERS |
project_id, grant, revoke, create |
十一、典型示例
用户请求:
通过 Rube MCP(Composio)自动化 Basecamp 的项目管理、待办、消息、人员与待办清单组织。
Agent 的标准执行路径:
- 先调用
RUBE_SEARCH_TOOLS确认 Basecamp 工具 schema 与当前连接状态; - 通过
RUBE_MANAGE_CONNECTIONS确认 toolkitbasecamp连接为 ACTIVE,不满足则引导用户完成 OAuth; - 用
BASECAMP_GET_PROJECTS定位目标项目并捕获bucket_id,从项目dock中解析todoset_id与message_board_id; - 按需执行五大工作流之一(建清单/建任务、发消息、管人员、建分组、查项目),全部 ID 使用整数,富文本一律用 HTML,列表接口注意分页;
- 最终向用户返回
app_url等面向用户的可点击确认链接,而非裸 ID。
十二、使用边界与限制
- 仅当任务明确匹配上文所述范围时使用本 Skill,不要扩大应用到无关操作。
- 输出不能替代环境特定的验证、测试或专家评审——尤其是涉及权限变更(grant/revoke/create)与消息发布等写操作时。
- 若缺少必要输入、权限、安全边界或成功标准,应停止执行并向用户请求澄清。
- 本 Skill 风险等级标记为 critical(涉及账号级写操作),Agent 在执行时应严格遵循最小权限原则,先读后写、先查重后创建。