
使用 Rube MCP 自动化 Habitica 任务awesome-codex-skills 的 habitica-automation 技能实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skillsHabitica 是一款以游戏化方式管理日常任务与习惯的效率工具而本仓库 composio-skills/habitica-automation/SKILL.md 提供的habitica-automation技能可以让 Codex Agent 通过 Rube MCPComposio 的统一 MCP 端点直接驱动 Habitica 官方 API完成任务的增删改查、打卡与习惯追踪等真实操作。读完本文你将掌握从接入 Rube MCP、建立 Habitica 连接到先搜索工具 Schema、再校验连接、最后执行工具的完整自动化工作流并了解批量操作与完整 Schema 获取等进阶用法。技能是什么一份可被 Codex 自动触发的指令包根据仓库 README.md 的说明Codex Skills 是模块化的指令包每个技能独占一个目录内含带 YAML frontmatternamedescription的SKILL.md。Codex 依据description判断何时触发技能触发后才加载正文从而保持上下文精简。habitica-automation的 frontmatter 定义如下--- name: habitica-automation description: Automate Habitica tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---要点解读name技能唯一标识即habitica-automationdescription声明通过 Rube MCP 自动化 Habitica 任务并强调始终先搜索工具以获取当前 Schema——这是该技能最核心的纪律requires.mcp: [rube]声明本技能依赖名为rube的 MCP 服务器Codex 只有在 Rube MCP 已接入时才会正确执行本技能。从仓库结构看composio-skills 目录下包含数百个结构完全一致的同类技能如cal-automation、gmail-automation等它们共享同一套 Rube MCP 调用范式因此本技能总结的流程同样适用于其它工具包。前置条件在执行任何 Habitica 自动化之前需要满足三项前置条件Rube MCP 必须已连接环境中应存在RUBE_SEARCH_TOOLS工具可用Habitica 连接必须处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS且 toolkit 指定为habitica建立连接始终先调用RUBE_SEARCH_TOOLS因为工具 Schema 会随版本变化任何执行前都必须先获取最新 Schema。环境搭建接入 Rube MCP 并建立 Habitica 连接获取 Rube MCP在客户端的 MCP 服务器配置中添加端点https://rube.app/mcp即可。无需任何 API Key——只需要添加端点就能直接使用这是该方案最便捷之处。Rube MCP 由 Composio 提供本质上是一个 MCP Gateway根据 README.md 的描述Composio MCP Gateway 为 1000 集成提供单一 MCP 端点内置认证、基于团队team-based的访问控制、审计日志与生产级可靠性。habitica正是这上千个集成toolkit之一。四步建立连接接入 Rube MCP 后按以下顺序确认环境可用验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能正常响应发起连接调用RUBE_MANAGE_CONNECTIONStoolkit 指定为habitica完成授权如果连接状态不是 ACTIVE按照返回的认证链接auth link完成授权设置通常是 OAuth 流程确认状态在运行任何工作流之前务必确认连接状态显示为 ACTIVE。工具发现让 Agent 先问有什么可用Habitica 工具包的可用工具tool slug、输入 Schema、推荐执行计划与已知陷阱known pitfalls都通过RUBE_SEARCH_TOOLS获取。首次接入时建议用如下调用完成初始化RUBE_SEARCH_TOOLS queries: [{use_case: Habitica operations, known_fields: }] session: {generate_id: true}参数说明use_case描述你要完成的任务场景首轮可以用宽泛的Habitica operations后续针对具体任务细化如create a Habitica taskknown_fields已知字段初始为空字符串即可session.generate_id: true让系统生成新的会话 ID用于后续会话复用。该调用会返回可用工具 slug 列表、每个工具的输入 Schema、推荐的执行计划以及已知陷阱提示是后续一切执行动作的依据。核心工作流搜索 → 校验连接 → 执行这是本技能推荐的固定三步模式任何 Habitica 自动化任务都应遵循。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Habitica task}] session: {id: existing_session_id}将use_case替换为具体任务描述例如给今天添加一个习惯任务并复用已有会话 ID。此步骤产出确切的tool_slug与参数 Schema。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [habitica] session_id: your_session_id在执行任何工具前用RUBE_MANAGE_CONNECTIONS确认habiticatoolkit 的连接状态为 ACTIVE。如果连接过期或未授权返回结果中会包含重新认证所需的信息。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id要点tool_slug必须是 Step 1 搜索结果中返回的 slug不得硬编码arguments必须严格遵循搜索结果给出的字段名与类型memory参数必须始终携带即使内容为空也要传{}session_id复用当前工作流的会话 ID。已知陷阱与最佳实践原技能文档总结的六条经验值得逐条落实陷阱/原则说明Always search first工具 Schema 会变化。绝不在不调用RUBE_SEARCH_TOOLS的情况下硬编码 tool slug 或参数Check connection执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVESchema compliance严格使用搜索结果中的精确字段名与类型字段拼写或类型错误将导致调用失败Memory parameterRUBE_MULTI_EXECUTE_TOOL调用中始终包含memory参数即使为空{}Session reuse同一工作流内复用会话 ID新工作流生成新的会话 IDPagination检查响应中的分页令牌pagination tokens若结果未取完需继续抓取直到完整快速参考五类操作速查表OperationApproach查找工具Find toolsRUBE_SEARCH_TOOLS配合 Habitica 相关的 use case建立连接ConnectRUBE_MANAGE_CONNECTIONStoolkit 指定为habitica执行操作ExecuteRUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slug批量操作Bulk opsRUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 SchemaFull schemaRUBE_GET_TOOL_SCHEMAS适用于带schemaRef的工具其中批量操作当需要对多个 Habitica 任务执行同类型操作如批量打卡、批量更新时可改用RUBE_REMOTE_WORKBENCH在其中以run_composio_tool()方式编排多次工具调用减少往返、提升吞吐完整 Schema若搜索返回的工具带有schemaRef引用可调用RUBE_GET_TOOL_SCHEMAS拉取完整、最新的参数定义确保复杂参数的字段与枚举值准确无误。仓库中的配套生态另一种实现路径需要说明的是Rube MCP 并不是本仓库驱动外部应用的唯一方式。connect/SKILL.md 展示了另一条基于Composio CLI的路线通过composio link habitica建立 OAuth 连接用composio search create a habitica task发现工具 slug再用composio execute TOOL_SLUG -d {...}在终端直接执行并支持--get-schema、--dry-run等方式在执行前校验参数。两者的共同原则与本技能一致先搜索发现工具与 Schema再执行调用绝不硬编码。你可以根据运行环境MCP 客户端 vs 终端 Shell选择合适的一种。小结habitica-automation技能的完整闭环可以概括为接入 Rube MCP零 API Key→ 通过RUBE_MANAGE_CONNECTIONS激活 Habitica 连接 → 用RUBE_SEARCH_TOOLS获取最新 Schema → 按 Schema 用RUBE_MULTI_EXECUTE_TOOL执行 → 复杂场景切换到RUBE_REMOTE_WORKBENCH批量编排。这套搜索优先、连接先行、Schema 严格合规的模式不仅适用于 Habitica也可直接复用到 composio-skills 目录下其余数百个工具包技能中是让 Codex 从生成建议走向真实执行的通用方法论。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考