Agentic Awesome Skills 实战:基于 Rube MCP(Composio)的 Basecamp 全流程自动化 Skill 指南

原创2026-09-21 09:40:491,741 阅读
文章标签:人工智能AI 技能AI 插件MCP 服务开发工具AI 应用

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 演进导致参数不匹配。

接入步骤

  1. 添加 Rube MCP 服务器:在客户端配置中将 https://rube.app/mcp 添加为 MCP server 端点。无需任何 API Key——添加端点即可工作。
  2. 验证连通性:确认 RUBE_SEARCH_TOOLS 有响应。
  3. 建立 Basecamp 连接:调用 RUBE_MANAGE_CONNECTIONS,指定 toolkit 为 basecamp。
  4. 完成 OAuth 授权:若连接状态不是 ACTIVE,跟随返回的授权链接完成 Basecamp OAuth 流程。
  5. 确认状态后再执行:只有连接状态显示 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:整数类型,项目/桶 ID
  • todolist_id:整数类型,待办清单 ID
  • content:待办事项内容(必填)
  • description:待办的 HTML 格式详情
  • assignee_ids:整数人员 ID 数组
  • due_on:截止日期,格式 YYYY-MM-DD
  • starts_on:开始日期,格式 YYYY-MM-DD
  • notify:布尔值,是否通知被指派者(默认 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。

四、核心工作流二:发布与管理消息

何时使用:用户想向项目消息板发布消息,或更新已有消息。

标准工具调用序列

  1. BASECAMP_GET_PROJECTS —— 找到目标项目与 bucket_id(前置)
  2. BASECAMP_GET_MESSAGE_BOARD —— 获取项目消息板 ID(前置)
  3. BASECAMP_CREATE_MESSAGE —— 在消息板上创建新消息(必选)
  4. BASECAMP_POST_BUCKETS_MESSAGE_BOARDS_MESSAGES —— 备选的消息创建工具(兜底)
  5. BASECAMP_GET_MESSAGE —— 按 ID 读取单条消息(可选)
  6. BASECAMP_PUT_BUCKETS_MESSAGES —— 更新已有消息(可选)

关键参数

  • bucket_id:整数类型,项目/桶 ID
  • message_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。

五、核心工作流三:管理人员与项目访问

何时使用:用户想列出人员、管理项目访问,或添加新用户。

标准工具调用序列

  1. BASECAMP_GET_PEOPLE —— 列出当前用户可见的所有人员(必选)
  2. BASECAMP_GET_PROJECTS —— 找到目标项目(前置)
  3. BASECAMP_LIST_PROJECT_PEOPLE —— 列出特定项目上的人员(必选)
  4. BASECAMP_GET_PROJECTS_PEOPLE —— 列出项目成员的替代工具(替代方案)
  5. BASECAMP_PUT_PROJECTS_PEOPLE_USERS —— 授予或撤销项目访问权限(变更访问必选)

PUT_PROJECTS_PEOPLE_USERS 关键参数

  • project_id:整数类型,项目 ID
  • grant:整数人员 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 创建用户会一步到位同时授予项目访问权限。

六、核心工作流四:用分组组织待办

何时使用:用户想把清单内的待办组织进颜色编码的分组。

标准工具调用序列

  1. BASECAMP_GET_PROJECTS —— 找到目标项目(前置)
  2. BASECAMP_GET_BUCKETS_TODOLISTS —— 获取待办清单详情(前置)
  3. BASECAMP_GET_TODOLIST_GROUPS —— 列出清单中已有分组(可选)
  4. BASECAMP_GET_BUCKETS_TODOLISTS_GROUPS —— 列出分组的替代工具(替代方案)
  5. BASECAMP_POST_BUCKETS_TODOLISTS_GROUPS —— 在待办清单中创建新分组(必选)
  6. BASECAMP_CREATE_TODOLIST_GROUP —— 创建分组的替代工具(替代方案)

关键参数

  • bucket_id:整数类型,项目/桶 ID
  • todolist_id:整数类型,待办清单 ID
  • name:分组标题(必填)
  • color:视觉颜色标识,可选值为固定调色板:white、red、orange、yellow、green、blue、aqua、purple、gray、pink、brown
  • status:列出的过滤条件——"archived" 或 "trashed"(省略则只列活跃分组)

陷阱清单

  • POST_BUCKETS_TODOLISTS_GROUPS 与 CREATE_TODOLIST_GROUP 近乎等价,任选其一。
  • 颜色必须是固定调色板中的值;任意 hex/rgb 值不受支持。
  • 分组是待办清单内的子区块,不是独立实体。

七、核心工作流五:浏览与检视项目

何时使用:用户想列出项目、获取项目详情,或探索项目结构。

标准工具调用序列

  1. BASECAMP_GET_PROJECTS —— 列出所有活跃项目(必选)
  2. BASECAMP_GET_PROJECT —— 获取某个项目的完整详情(可选)
  3. 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 的标准执行路径:

  1. 先调用 RUBE_SEARCH_TOOLS 确认 Basecamp 工具 schema 与当前连接状态;
  2. 通过 RUBE_MANAGE_CONNECTIONS 确认 toolkit basecamp 连接为 ACTIVE,不满足则引导用户完成 OAuth;
  3. 用 BASECAMP_GET_PROJECTS 定位目标项目并捕获 bucket_id,从项目 dock 中解析 todoset_id 与 message_board_id;
  4. 按需执行五大工作流之一(建清单/建任务、发消息、管人员、建分组、查项目),全部 ID 使用整数,富文本一律用 HTML,列表接口注意分页;
  5. 最终向用户返回 app_url 等面向用户的可点击确认链接,而非裸 ID。

十二、使用边界与限制

  • 仅当任务明确匹配上文所述范围时使用本 Skill,不要扩大应用到无关操作。
  • 输出不能替代环境特定的验证、测试或专家评审——尤其是涉及权限变更(grant/revoke/create)与消息发布等写操作时。
  • 若缺少必要输入、权限、安全边界或成功标准,应停止执行并向用户请求澄清。
  • 本 Skill 风险等级标记为 critical(涉及账号级写操作),Agent 在执行时应严格遵循最小权限原则,先读后写、先查重后创建。

延伸阅读

登录后查看全文
agentic-awesome-skills