fitbit-automation

fitbit-automation skill 概览

fitbit-automation 能做什么

fitbit-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动执行 Fitbit 相关操作。它不是让 agent 硬编码 Fitbit API 调用，而是引导 agent 先用 RUBE_SEARCH_TOOLS 发现当前 Fitbit tool schemas，再用 RUBE_MANAGE_CONNECTIONS 验证用户的 Fitbit 连接状态，最后根据用户请求的健康或活动工作流执行合适的 Rube tool。

当你希望 AI agent 在 Fitbit 生态内完成操作、但又不想每次都手动查阅 Composio toolkit docs 时，fitbit-automation skill 最有价值。

最适合的用户和工作流

fitbit-automation skill 适合已经在使用支持 MCP 的 AI client，并希望把 Fitbit 自动化用于 Workflow Automation、个人仪表盘、健康日志、周期性报告，或由 assistant 驱动的健康数据检索的用户。如果你的工作流依赖最新的 Composio Fitbit toolkit schemas，它尤其适用，因为该 skill 明确要求在执行前先进行 tool discovery。

典型使用场景包括：让 agent 在当前 Fitbit toolkit connection 支持的范围内，检索活动、睡眠、心率或个人资料相关数据。

关键差异：schema-first execution

fitbit-automation 的重要设计选择在于：它不假设 tool 名称稳定，也不假设参数固定。它要求 agent 先调用 RUBE_SEARCH_TOOLS，再使用返回的 execution plan 和 input schema。这样一来，当 Composio 更新 tool 名称、必填字段或认证行为时，这个 skill 会比静态 prompt 更安全。

采用前提

在安装或依赖这个 skill 之前，请确认你的 AI client 支持 MCP，并且可以连接到 Rube：https://rube.app/mcp。你还需要通过 RUBE_MANAGE_CONNECTIONS 建立一个 toolkit 为 fitbit 的有效 Fitbit connection。如果 connection 不是 ACTIVE，工作流会停止，直到用户完成返回的授权链接。

如何使用 fitbit-automation skill

fitbit-automation 安装与设置路径

从 Composio skill collection 安装该 skill：

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

然后在你的 client 中添加 Rube MCP 配置：

https://rube.app/mcp

上游 skill 不包含辅助脚本、references 或 README，因此最需要检查的主文件是：

composio-skills/fitbit-automation/SKILL.md

请先阅读这个文件，因为它定义了必需的 MCP 依赖、设置顺序，以及 tool-discovery 模式。

这个 skill 需要你提供哪些输入

为了可靠地使用 fitbit-automation，不要只对 agent 说“check my Fitbit”。更好的请求应包含：

• 你想完成的 Fitbit 任务
• 需要的数据类型或操作类型
• 日期范围或时间周期
• 输出格式，例如 summary、table、JSON 或 report
• agent 是只需要检索数据，还是还要执行后续操作

较弱的 prompt：

“Get my Fitbit data.”

更强的 prompt：

“Use fitbit-automation to retrieve my Fitbit sleep and activity data for the last 7 days. First discover the current Fitbit tools with RUBE_SEARCH_TOOLS, confirm my Fitbit connection is active, then return a concise table with date, sleep duration, steps, active minutes, and any missing fields.”

这样能提升结果质量，因为 agent 会明确知道使用场景、必需的 discovery 步骤、connection 依赖、时间范围和期望的输出结构。

实际推荐工作流

一个实用的 fitbit-automation 使用流程如下：

1. 要求 agent 使用该 skill 完成一个具体的 Fitbit 任务。
2. 要求在执行前先调用 RUBE_SEARCH_TOOLS。
3. 让 agent 用 RUBE_MANAGE_CONNECTIONS 检查 toolkit fitbit 的状态。
4. 如果未激活，在模型外完成授权链接。
5. 当 connection 变为 ACTIVE 后，重新运行任务。
6. 要求 agent 说明它选择了哪个 tool，以及选择原因。
7. 在把返回数据用于报告或下游自动化之前，先进行校验。

对于持续运行的自动化任务，第一次运行建议保持交互式。等 agent 确认了正确的 tool 和字段后，再用相同的 prompt 模式复用，只更新日期或报告要求。

实用 prompt 模板

可以使用这个结构：

“Use fitbit-automation for [specific Fitbit task]. Search current Rube tools first for [task]. Check my Fitbit connection status. If active, execute the best matching tool using the discovered schema. Return [format]. If a required field is missing, ask me before calling the tool.”

这个模式可以避免常见失败：使用过期 schema、跳过授权、猜测参数，或返回难以复用的非结构化输出。

fitbit-automation skill 常见问题

fitbit-automation 只适合开发者吗？

不是，但它默认你能熟练使用已启用 MCP tools 的 AI client。非开发者也可以使用，前提是他们的 client 已经配置好 Rube MCP。最偏技术的步骤是连接 Rube，并通过返回的 connection flow 授权 Fitbit。

它比普通 Fitbit prompt 好在哪里？

普通 prompt 可能会幻觉出 API endpoints，或者编造 tool 参数。fitbit-automation skill 会告诉 agent 使用 RUBE_SEARCH_TOOLS 查询当前 schemas 和推荐的 execution plans。这是它的主要价值：把一个模糊的 Fitbit 请求，转换成带实时 schema discovery 的 tool-driven workflow。

什么时候不应该使用 fitbit-automation？

如果你需要的是独立的 Fitbit API wrapper、离线数据处理，或不依赖 MCP 运行的工作流，就不应使用 fitbit-automation。如果你无法通过 Rube 授权 Fitbit connection，或者你的 client 无法暴露 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS，它也不适合。

这个 skill 能保证执行所有 Fitbit 操作吗？

不能。可用操作取决于 Composio 当前的 Fitbit toolkit，以及你已授权账户的权限。该 skill 要求先搜索 tools，正是为了处理这种不确定性。如果 tool discovery 没有返回你想要的操作，agent 应该说明这个限制，而不是编造一个工作流。

如何改进 fitbit-automation skill

让 fitbit-automation prompts 更具体

最大的质量提升来自具体性。请写明准确的指标、时间范围和期望输出。例如，“summarize last month’s step trends by week” 比 “analyze my fitness” 更好。如果你需要下游自动化，请要求输出机器可读格式，例如包含稳定字段名的 JSON。

减少 connection 和 schema 失败

多数失败都来自跳过设置。在 prompt 中明确写出：“Do not execute until RUBE_SEARCH_TOOLS has returned the current schema and RUBE_MANAGE_CONNECTIONS confirms Fitbit is active.” 这样可以避免 agent 猜测 tool 名称，或在授权完成前尝试调用。

基于第一次输出继续迭代

拿到第一次结果后，基于实际返回字段要求进一步优化：

• “Add a missing-data column.”
• “Group by week instead of day.”
• “Explain which Fitbit fields were unavailable.”
• “Convert this into CSV-ready rows.”
• “Create a reusable prompt for this same report every Monday.”

这样可以把 fitbit-automation 从一次性检索 skill，变成可重复使用的工作流组件。

改进上游 skill 包

当前 repository 主要围绕 SKILL.md，skill 文件夹中没有支持文件。值得补充的内容包括：常见 Fitbit 任务的 example prompts、示例 RUBE_SEARCH_TOOLS results、inactive connections 的 troubleshooting notes，以及用于 sleep、activity 和 heart-rate reports 的 output templates。这些补充会让 fitbit-automation skill 在安装前更容易评估，也更便于 agents 稳定执行。