habitica-automation

habitica-automation skill 概览

habitica-automation 能做什么

habitica-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 运行 Habitica 工作流。它不会让 agent 凭空猜测 Habitica API 调用，而是要求 agent 先发现当前的 Composio Habitica tool schemas，确认用户的 Habitica 连接状态，然后再执行任务、习惯、dailies、todos 或相关账号操作的管理动作。

适合的用户和使用场景

habitica-automation skill 最适合已经把 Habitica 作为生产力系统使用，并希望借助 AI 自动化工作流、但不想手动对接 Habitica API 的用户。它适用于一些重复性操作，例如把计划笔记转换成 Habitica tasks，检查或更新任务列表，批量创建 todos，或搭建一个轻量级的每日复盘流程。

核心差异：先发现工具，再执行动作

这个 skill 最重要的设计选择，是它的“先搜索工具”规则。Rube MCP tool names、schemas 以及可用的 Habitica actions 都可能变化，因此 habitica-automation 会指示 agent 在执行前先调用 RUBE_SEARCH_TOOLS。相比假定旧字段或硬编码 tool names 的静态 prompt，这让 habitica-automation 更可靠。

采用前需要先确认的条件

你需要一个支持 MCP 的客户端、已作为 server 配置好的 Rube MCP，以及通过 Composio 建立的有效 Habitica 连接。如果你的环境无法调用 MCP tools，这个 skill 就不能直接自动化 Habitica；它最多只能帮你起草工作流方案。

如何使用 habitica-automation skill

habitica-automation 安装与设置路径

如果你的客户端支持安装 skill，可以从仓库路径安装：

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

然后在客户端配置中添加 Rube MCP：

https://rube.app/mcp

之后，确认 agent 可以访问 RUBE_SEARCH_TOOLS。如果连接状态不是 ACTIVE，请使用 toolkit 为 habitica 的 RUBE_MANAGE_CONNECTIONS，并完成返回的授权流程。在确认连接状态之前，不要让 agent 创建或更新 Habitica 项目。

你需要提供哪些输入

要让 habitica-automation 用得更稳，需要提供期望的 Habitica 结果、对象类型、时间规则，以及任何命名约定。较弱的请求是：“整理我的 Habitica。”更好的 prompt 是：

“Use habitica-automation for Workflow Automation. First discover current Habitica tools with Rube. If my connection is active, create five todos from this project plan. Prefix each task with [Website], set priority based on urgency, and do not mark anything complete.”

这个写法更有效，因为它明确了动作、目标实体、转换规则和安全边界。

更可靠的执行流程

推荐流程是：发现工具、检查连接、查看可用 schemas、草拟计划执行的操作、在破坏性操作或批量操作前请求确认，然后再执行。对于批量变更，要求 agent 在调用写入类 tools 之前先展示一张简短的预览表。对于每日计划，请提供原始笔记、截止日期，以及哪些条目应该成为 habits、dailies 或 todos。

优先阅读的仓库文件

上游 skill 结构很精简，主要位于 composio-skills/habitica-automation 下的 SKILL.md。请先阅读这个文件，因为它包含必需的 MCP 依赖、设置顺序、工具发现模式，以及连接检查指引。当前仓库预览中没有配套脚本、规则或参考文件夹，因此是否值得安装，主要取决于你的客户端能否运行 Rube MCP tools。

habitica-automation skill 常见问题

没有 Rube MCP，habitica-automation 够用吗？

不够。这个 skill 依赖 Rube MCP 和 Composio Habitica toolkit。没有 MCP tool access 时，它仍然可以围绕 Habitica 生产力设计提供对话式建议，但无法可靠地执行实时 Habitica 自动化。

它为什么比普通的 Habitica prompt 更好？

普通 prompt 可能会编造 API 字段，或假设已经过时的 tool names。habitica-automation 明确要求先使用 RUBE_SEARCH_TOOLS，因此 agent 应该在行动前使用当前 schemas 和可用的 tool slugs。这是它主要的可靠性优势。

habitica-automation 对新手友好吗？

如果你的 AI 客户端已经支持 MCP 设置，它对新手是友好的。Habitica 侧在授权后比较简单，但 MCP 配置可能是采用门槛。新手应从只读或低风险任务开始，例如列出可用的 Habitica 操作，或先草拟 todos 供确认。

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

如果自动化必须按计划无人值守运行，而你的环境没有提供调度和安全执行控制，就不应使用它。另一个不适合的情况是，你需要当前 Composio toolkit 未暴露的自定义 Habitica API 功能；这时，直接进行 API 开发可能更合适。

如何改进 habitica-automation skill

用具体的 Habitica 规则改进 prompt

提升 habitica-automation 结果的最佳方式，是把你真实的生产力规则提供给 agent。包括你如何区分 habits、dailies 和 todos；优先级应如何分配；是否允许设置 due dates；以及你使用哪些 labels 或 prefixes。这样可以减少误分类，并避免任务列表变得混乱。

避免常见失败模式

常见失败包括跳过工具发现、在 Habitica 连接尚未激活前就执行动作、从模糊笔记中创建过多任务，或错误混用 Habitica object types。可以明确告诉 agent：“Search tools first, verify connection, summarize the planned changes, then wait for approval before writing.”

在第一次输出后继续迭代

第一次运行后，检查已创建或拟创建条目的命名、优先级和颗粒度。然后用示例细化 prompt，例如：“Break tasks larger than 30 minutes into separate todos,” 或 “Recurring chores should be dailies, not todos.” 这些修正会在后续 habitica-automation 使用中快速累积效果。

负责任地扩展这个 skill

如果你维护本地版本，可以为最常用的工作流添加示例：weekly planning、task import、daily reset、reward review，或清理 stale todos。示例应保持 schema-agnostic，并保留调用 RUBE_SEARCH_TOOLS 的规则，因为当前工具发现是这个 skill 防止自动化指令过时的主要保护机制。