iqair-airvisual-automation
作者 ComposioHQiqair-airvisual-automation 是一个用于通过 Composio Rube MCP 实现 IQAir AirVisual Workflow Automation 的 Claude skill。它会引导 agents 先搜索当前可用工具，验证 iqair_airvisual connection，检查实时 schemas，并在更少猜测的情况下执行已批准的空气质量相关操作。
评分：66/100。该 skill 达到收录标准，因为它提供了足够的 MCP 专项指引，能帮助 agents 以比通用 prompt 更少的猜测来触发 IQAir AirVisual 自动化，尤其是在 Rube 工具发现和 connection 设置方面。目录用户应将其视为轻量级集成 skill，而不是成熟的工作流包；它高度依赖实时 Composio/Rube schemas 和外部文档。
- 有效的 frontmatter 和清晰描述明确了触发场景：通过 Rube MCP/Composio 自动化 IQAir AirVisual 任务。
- 前置条件和设置步骤写得比较明确，包括添加 Rube MCP endpoint、检查 RUBE_SEARCH_TOOLS，以及激活 iqair_airvisual connection。
- 该 skill 为 agents 提供了有用的执行模式：先发现工具，使用返回的 schemas，并且只在确认 connection 处于 active 状态后继续。
- 除 SKILL.md 外未提供支持文件、脚本、示例或内置参考资料，因此用户需要依赖实时 Rube 工具发现和外部 Composio 文档。
- 针对具体 IQAir AirVisual 任务的操作细节较为通用；该 skill 更强调搜索当前 schema，而不是记录完整、可直接执行的空气质量工作流。
iqair-airvisual-automation skill 概览
iqair-airvisual-automation 能做什么
iqair-airvisual-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP toolkit 自动化处理 IQAir AirVisual 相关任务。它的核心价值不是提供一段固定的空气质量脚本，而是教 agent 先发现当前可用的 IQAir AirVisual tools，检查实时 schema，确认用户连接状态，然后再通过 Rube 执行正确的操作。
适合的用户与工作流
如果你希望 AI agent 帮你围绕 IQAir AirVisual 数据或账号操作做 Workflow Automation，尤其是在 tool schema 可能变化的情况下，这个 skill 会很合适。典型用法包括：查询当前可用的空气质量相关操作、确认需要哪些参数、准备执行计划，并且只在 Rube connection 已经激活后执行受支持的 IQAir AirVisual action。
核心差异：先搜索工具，再执行
这个 skill 最重要的行为模式是“先发现，再执行”。它不会假设固定的 function name 或旧版参数格式，而是要求 agent 针对具体的 IQAir AirVisual 任务先调用 RUBE_SEARCH_TOOLS。当 Composio toolkit 发生变化时，这会让 iqair-airvisual-automation skill 比普通 prompt 更可靠。
采用前需要确认的限制
你需要一个支持 MCP 的客户端，已经配置好的 Rube MCP，并且通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit iqair_airvisual 建立了处于 active 状态的 IQAir AirVisual connection。这个 skill 的 repository 有意保持精简：实际操作说明集中在 SKILL.md，没有额外的脚本、规则或参考目录需要检查。
如何使用 iqair-airvisual-automation skill
iqair-airvisual-automation 的安装与设置路径
从 Composio skills repository 安装该 skill：
npx skills add ComposioHQ/awesome-claude-skills --skill iqair-airvisual-automation
然后在你的客户端中添加以下地址来配置 Rube MCP：
https://rube.app/mcp
在请求真实的 IQAir AirVisual 任务之前，先确认 RUBE_SEARCH_TOOLS 可用。接着使用 RUBE_MANAGE_CONNECTIONS，并指定 toolkit iqair_airvisual。如果 connection 不是 ACTIVE，请完成返回的授权流程，并在尝试任何操作前确认状态已经 active。
这个 skill 需要你提供哪些输入
为了获得更好的结果，请描述实际要完成的 AirVisual 任务，而不是只写产品名。建议包含目标地点、指标、时效要求、输出格式，以及你希望 agent 直接执行还是只做计划。
较弱的 prompt：
“Use IQAir.”
更好的 prompt：
“Use iqair-airvisual-automation to discover current IQAir AirVisual tools, check whether my iqair_airvisual connection is active, and find the required schema for getting current air-quality information for Paris. Do not execute until you show me the exact tool slug and required fields.”
这样写效果更好，因为它会强制进行 schema discovery、connection checking，并在执行前设置一个安全的确认点。
更可靠的执行工作流
建议一开始就要求 agent 调用 RUBE_SEARCH_TOOLS，并提供与你真实任务匹配的 use case，例如 “current air quality by city” 或 “available IQAir AirVisual operations”。搜索结果应返回可用的 tool slugs、input schemas、execution plans 和 pitfalls。之后，再让 agent 将你的请求映射到返回的 schema，明确补齐缺失字段，然后才调用选定的 tool。
一个实用的 iqair-airvisual-automation 使用顺序是：
- 针对准确的 IQAir AirVisual use case 搜索 tools。
- 确认
iqair_airvisualconnection 状态。 - 查看 live schema 中的必填字段。
- 要求 agent 生成拟调用方案。
- 批准执行，或补充、修改缺失输入。
- 请求返回数据的简明摘要，并说明任何限制。
优先阅读的 repository 文件
先阅读 composio-skills/iqair-airvisual-automation/SKILL.md。它包含 prerequisites、setup flow、tool discovery requirement 和核心 workflow pattern。文件树中没有可见的配套脚本或参考文档，因此安装决策的重点在于：你的环境是否支持 Rube MCP，以及你是否接受以 live tool discovery 作为执行模型。
iqair-airvisual-automation skill 常见问题
iqair-airvisual-automation 适合新手吗？
适合，前提是你已经在使用支持 MCP 的 AI client。这个 skill 的设置流程很短，但新手需要理解两个组件：Rube MCP 提供 tool interface，Composio 负责管理 IQAir AirVisual connection。如果 RUBE_SEARCH_TOOLS 不可用，或 iqair_airvisual connection 不可用，这个 skill 就无法完成有意义的工作。
它比普通 prompt 好在哪里？
普通 prompt 可能会编造旧的 API 字段，或假设你的 connected toolkit 中存在某个 IQAir endpoint。iqair-airvisual-automation skill 会指引 agent 先搜索 Rube 当前的 tool catalog，然后使用返回的 schema。这样可以减少猜测，并让工作流更能适应 toolkit 更新。
什么时候不应该使用这个 skill？
如果你只需要离线处理、想绕过 Composio 直接编写原始 API 代码，或在检查 Rube 当前 tools 之前就需要保证支持某个特定 AirVisual endpoint，就不适合使用它。无法授权 IQAir AirVisual connection，或你的客户端不支持 MCP tool calls 时，也应避免使用。
它会自动执行操作吗？
这个 skill 的设计目标是通过 Rube MCP 支持执行，但你可以、也应该控制审批边界。对于读取类任务，可以在确认 schema 后允许执行。对于会改动账号或含义不明确的任务，应要求 agent 在运行任何操作前展示选定的 tool slug、必填字段和预期影响。
如何改进 iqair-airvisual-automation skill 的使用效果
用任务上下文改进 prompt
最大的改进来自于给 agent 足够的上下文，让它能搜索到正确的 tool。不要只写 “get air quality”，而应说明 city、country 或已知 coordinates、所需 metric、freshness requirement 以及最终输出形式。例如：“Find the current AQI and main pollutant for Los Angeles, return a short human-readable summary, and include any timestamp from the tool response.”
减少常见失败模式
常见失败包括跳过 RUBE_SEARCH_TOOLS、使用猜测出来的字段名、在 connection active 之前尝试运行，或在未检查可用性的情况下请求不受支持的 historical 或 forecast data。可以在 prompt 中加入这句来避免问题：“Search tools first, use only returned schemas, and ask me for any required field that is missing.”
根据第一次 tool 结果继续迭代
拿到第一次响应后，要求 agent 验证返回数据是否完整满足目标。如果没有，让它用更窄的 use case 再次搜索，或请求更多字段。一个有用的 follow-up 是：“Compare the result against the original request, list missing information, and propose the next Rube tool call only if the current IQAir AirVisual toolkit supports it.”
结果看起来不对时该检查什么
重新打开 SKILL.md，确认 agent 是否遵循了预期顺序：Rube availability、connection management、tool discovery、schema mapping，然后才是 execution。如果输出仍然不完整，问题很可能不在 iqair-airvisual-automation skill 本身，而是缺少用户输入、授权未激活，或 Composio 的 iqair_airvisual toolkit 当前暴露的能力有限。