smugmug-automation

smugmug-automation skill 概览

smugmug-automation 用来做什么

smugmug-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP 工具包执行 SmugMug 相关任务。它不会把流程写死成某一套固定 API 调用，而是要求 agent 先发现当前可用的 SmugMug 工具 schema，检查用户的连接状态，然后根据用户请求的图片站点工作流执行合适的 Rube MCP 工具。

适合的用户和任务

这个 skill 最适合已经在使用 SmugMug、并希望 AI agent 协助处理运营类任务的用户，例如查找可用的 SmugMug 操作、准备相册或图片工作流、检查账号连接是否就绪，以及通过 Rube 执行受支持的 SmugMug 操作。它适用于 Workflow Automation 场景：agent 需要调用真实工具完成动作，而不仅仅是给出关于 SmugMug 的说明。

主要采用要求

关键依赖是 Rube MCP。该 skill 需要 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS，并且需要在 Composio 中有一个处于可用状态的 SmugMug 连接。如果你的客户端无法添加 MCP servers，或者你只想要不访问账号的离线建议，那么相比普通 prompt，smugmug-automation 不会带来太多额外价值。

它与通用 prompt 的区别

核心差异在于“先搜索工具”的模式。SmugMug 的工具名称和 schema 可能变化，因此该 skill 会避免假设已经过期的参数。通用 prompt 可能会编造 API 字段；而 smugmug-automation skill 会推动 agent 获取实时工具定义、检查必填输入，并按已验证连接状态的执行路径操作。

如何使用 smugmug-automation skill

smugmug-automation 安装上下文

从 Composio skills repository 安装该 skill，然后确保你的 AI client 可以访问 Rube MCP：

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

在支持 MCP 的客户端中添加 Rube endpoint：

https://rube.app/mcp

然后确认 RUBE_SEARCH_TOOLS 可用。在执行任何 SmugMug 操作前，agent 应先用 toolkit smugmug 调用 RUBE_MANAGE_CONNECTIONS；如果连接状态不是 ACTIVE，需要完成返回的授权流程。

你需要提供给 skill 的输入

为了更好地使用 smugmug-automation，请告诉 agent 你真正想达成的 SmugMug 结果，而不是只说“管理我的照片”。请包含目标对象类型、筛选条件、命名规则、可见性偏好，以及任何安全限制。

较弱的 prompt：

“整理我的 SmugMug 相册。”

更好的 prompt：

“Use smugmug-automation to inspect available SmugMug tools, confirm my connection, then find actions for creating or updating albums. I want a new private album for client proofing named Smith Wedding Proofs, and I want you to show the required fields before executing anything.”

这样效果更好，因为 agent 可以围绕具体用例搜索工具，把你的目标映射到当前 schema，并在可能更改账号内容的操作前暂停确认。

推荐执行流程

可靠的 smugmug-automation 使用指南应按以下顺序执行：

1. 使用 RUBE_SEARCH_TOOLS 搜索特定 SmugMug 任务所需的工具。
2. 查看返回的 tool slugs、schema、必填字段和潜在风险点。
3. 使用 RUBE_MANAGE_CONNECTIONS 检查 SmugMug 连接状态。
4. 向用户询问缺失的必填值。
5. 只执行已选定的 tool call。
6. 汇总发生了哪些变更、哪些失败了，以及哪些仍需人工复核。

不要跳过发现步骤。上游 skill 有意围绕实时 schema 查询来设计，因为 Rube 可用的 SmugMug actions 可能会因账号、toolkit 版本或连接状态而不同。

优先阅读的 repository 文件

这个 skill 很精简：主要需要查看的文件是 composio-skills/smugmug-automation/SKILL.md。重点关注其中的 prerequisites、setup steps、tool discovery pattern 和 core workflow pattern。当前目录树中没有额外的 scripts/、rules/、resources/ 或 metadata.json 文件，因此实现主要依赖规范、严格地使用 MCP 工具，而不是依赖辅助代码。

smugmug-automation skill 常见问题

smugmug-automation 只适合开发者吗？

不是，但它也不是完全零配置。只要 AI client 支持 MCP，并且用户可以完成 SmugMug 授权流程，非开发者也可以使用。开发者和自动化流程搭建者通常能获得最大价值，因为他们可以验证工具 schema、判断必填字段，并把该工作流接入更大的 AI 辅助运营流程中。

它能自动上传、编辑或整理照片吗？

有可能，但前提是当前 Composio SmugMug toolkit 暴露了所需工具，并且你的账号连接处于 active 状态。这个 skill 并不保证覆盖 SmugMug 的每一项功能。它的正确行为是先搜索当前 Rube 工具，然后只使用运行时返回的 actions 和 schema。

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

如果你需要的是独立的 SmugMug API client、批量迁移软件、图片编辑工具，或者不依赖 AI agent 就能运行的脚本，就不要使用 smugmug-automation。对于存在风险的账号级大范围变更，也应谨慎使用，除非你明确要求 agent 在执行前预览工具输入并请求确认。

它如何适配 Workflow Automation？

smugmug-automation for Workflow Automation 适合 SmugMug 只是更大流程中的一个步骤的场景：准备客户图库、检查可用的媒体操作、创建可重复的相册工作流，或把图片站点任务连接到 AI assistant。它的价值在于通过 Rube MCP 进行编排，而不是替代 SmugMug 界面中的每一个手动操作。

如何改进 smugmug-automation skill

用具体操作规则改进 prompt

提升 smugmug-automation 结果的最佳方式，是给 agent 明确的决策规则。说明它是否可以立即执行、是否必须在变更前询问、是否只能操作指定相册，或者是否应把结果限制在某个日期范围内。

示例：

“Use smugmug-automation. Search tools first. Do not modify or delete anything until I approve the exact tool name and payload. If multiple album matches exist, list them and ask me to choose.”

留意常见失败模式

最常见的问题包括 SmugMug 授权未激活、跳过工具发现、相册或图片目标描述含糊，以及假设 schema。如果 agent 在没有先使用 RUBE_SEARCH_TOOLS 的情况下就提出 tool call，请把它拉回正确流程。如果它要求你提供一个你不认识的字段，请先要求它展示返回的 schema 和必填参数，再继续操作。

基于首次输出继续迭代

第一次工具搜索后，要根据实际工具列表细化任务。例如，如果返回的工具支持创建相册，但不支持批量编辑元数据，就把工作流收窄到相册设置，并为不支持的步骤请求人工交接。这样可以避免 agent 超出实时 SmugMug toolkit 能安全完成的范围。

扩展时添加本地保护规则

如果你自定义这个 skill，请为破坏性操作、确认节点、命名规范和审计摘要添加清晰策略。更强的本地版 smugmug-automation skill 应保留核心规则——先搜索当前 schema——同时加入你所在组织针对客户图库、私密相册和生产图片库的安全要求。