spotlightr-automation

spotlightr-automation skill 概览

spotlightr-automation 能做什么

spotlightr-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动执行 Spotlightr 相关操作。它适合这样的工作流：AI agent 需要先发现当前可用的 Spotlightr tool schema，确认 Spotlightr 连接已完成认证，然后再使用 Rube MCP tools 执行动作，而不是凭空猜测 API 参数。

它的核心价值不在于提供一大套脚本库；这个 repository 里主要是一个聚焦的 SKILL.md。它真正的差异点在于操作模式：先搜索 tools，检查 Spotlightr connection，再按当前 schema 调用已发现的 tool。

最适合的用户与工作流

如果你使用 Claude 或其他支持 MCP 的 agent 来处理 Spotlightr 工作，例如视频库操作、账号级自动化，或通过 Composio 的 Spotlightr toolkit 暴露出来的可重复管理任务，这个 skill 会比较合适。

对于希望实现工作流自动化、但不想手写 Spotlightr API 调用的团队，它尤其有用。由于它明确要求 agent 在执行前调用 RUBE_SEARCH_TOOLS，当 schema 可能变化时，这个 skill 也更适合使用。

安装前需要了解的限制

spotlightr-automation skill 依赖你的客户端中可用的 Rube MCP，并且需要通过 RUBE_MANAGE_CONNECTIONS 创建一个有效的 Spotlightr connection。如果你的环境不能使用 MCP servers，或者你需要完全离线的自动化能力，仅靠这个 skill 并不够。

skill 文件夹中没有随附脚本、参考文件或辅助资源。你应该把它看作一套用于安全发现和执行 tool 的 agent 流程，而不是一个独立的 Spotlightr 自动化软件包。

如何使用 spotlightr-automation skill

spotlightr-automation 的安装场景

请按照你的 skill-enabled client 支持的方式，从 Composio skills repository 安装该 skill。对于 Claude 风格的 skill manager，预期来源是：

ComposioHQ/awesome-claude-skills，skill path 为 composio-skills/spotlightr-automation

典型安装命令可能类似：

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

安装完成后，在客户端配置中将 Rube MCP 添加为 server：

https://rube.app/mcp

然后确认 RUBE_SEARCH_TOOLS 可用。使用 RUBE_MANAGE_CONNECTIONS，toolkit 设置为 spotlightr，并完成返回的授权流程，直到 connection status 为 ACTIVE。

让 skill 更好工作的输入信息

当你的请求明确说明期望的 Spotlightr 结果、目标对象以及限制条件时，这个 skill 的表现最好。较弱的提示词是：

“Update my Spotlightr videos.”

更好的提示词是：

“Use spotlightr-automation to find the current Rube MCP tools for Spotlightr, confirm my Spotlightr connection is active, then look for a tool that can update metadata for videos in project X. Before executing, show the discovered tool name, required fields, and any missing values.”

这个提示词能提升输出质量，因为它要求 agent 完成 tool discovery、connection validation、schema inspection，并在真正修改前先暂停。

推荐的工作流模式

大多数 spotlightr-automation 使用场景都建议按这个顺序执行：

1. 要求 agent 针对具体的 Spotlightr 任务调用 RUBE_SEARCH_TOOLS。
2. 查看返回的 tool slugs、schemas、execution plan 和 pitfalls。
3. 使用 RUBE_MANAGE_CONNECTIONS 确认 Spotlightr connection。
4. 提供缺失的 IDs、titles、folders、project names 或筛选条件。
5. 只有在 agent 已经把你的请求映射到发现的 schema 后，才让它执行。
6. 对于破坏性操作或批量操作，要求先预览或确认。

最应该优先阅读的 repository 文件是 SKILL.md。它包含前置检查、Rube MCP 设置指引、tool discovery 要求，以及核心工作流模式。

实用提示词模板

如果想让 spotlightr-automation 更可靠地用于 Workflow Automation，可以使用这个模板：

“Use the spotlightr-automation skill. First call RUBE_SEARCH_TOOLS for this use case: [describe task]. Then check my Spotlightr connection with RUBE_MANAGE_CONNECTIONS. Do not guess fields. Show the selected tool, required inputs, optional inputs, and any missing information. After I confirm, execute the tool and summarize what changed.”

这比笼统地要求 “Spotlightr automation” 更好，因为它会让 agent 对齐这个 skill 最重要的安全规则：当前 schema 必须来自 Rube MCP discovery。

spotlightr-automation skill 常见问题

spotlightr-automation 是直接的 Spotlightr API client 吗？

不是。它是一个指导 agent 通过 Rube MCP 使用 Composio 的 Spotlightr toolkit 的 skill。agent 应该用 RUBE_SEARCH_TOOLS 发现可用 tools，并使用返回的 schemas，而不是自己编造直接 API 调用。

新手可以使用这个 skill 吗？

可以，前提是你能完成 MCP server 连接，并能走完类似 OAuth 的应用连接授权流程。新手应先做 connection verification，并在尝试批量修改前阅读 SKILL.md。这个 skill 的工作流本身很简单，但仍然需要配置 MCP。

它比普通提示词好在哪里？

普通提示词可能会让 agent 猜测可用的 Spotlightr 操作或参数。spotlightr-automation skill 明确要求先做 tool discovery，因此当 Composio tool schemas 发生变化，或 agent 不知道当前暴露了哪些 Spotlightr 操作时，它会更可靠。

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

如果你需要的是完整的本地自动化框架、预构建脚本、定时任务，或不依赖 MCP 的执行方式，就不应该使用它。对于高风险批量编辑，也应谨慎使用；除非你的提示词要求先 dry run、review schema，并在执行前获得明确确认。

如何改进 spotlightr-automation skill

运行 spotlightr-automation 前先改进输入

输入越清楚，自动化结果越好。请包含业务目标、Spotlightr object type、已知 IDs 或名称、筛选条件，以及操作是只读还是会产生修改。

不要这样写：

“Organize my videos.”

可以改成：

“Find tools for listing Spotlightr videos and updating video metadata. I want to identify videos with titles containing ‘Webinar 2024’ and add a consistent tag if the tool supports tagging. Show the schema before making changes.”

需要提前防范的常见失败模式

最主要的失败模式是跳过 tool discovery，直接假设 tool name 或 input shape。可以通过明确说明 “call RUBE_SEARCH_TOOLS first” 来避免。另一个常见问题是在没有确认有效 Spotlightr connection 的情况下执行写入操作。执行前应要求使用 RUBE_MANAGE_CONNECTIONS。

对于批量操作，要求 agent 先处理一个小样本，总结计划修改的内容，并等待批准。

根据第一轮输出继续迭代

当 agent 返回已发现的 tools 后，应基于真实 schema 细化请求。如果缺少必填字段，直接提供字段值，而不是让 agent 推断。如果有多个 tools 看起来都相关，要求它根据 required inputs、risk level 以及操作是否可回滚进行比较。

一个好的第二轮提示词是：

“Use the discovered schema only. Map each field to the value I provided, list unresolved fields, and propose the safest execution order.”

为团队工作流扩展这个 skill

如果你的团队经常使用 spotlightr-automation，可以考虑在 upstream skill 之外添加内部 runbooks：已批准的任务模板、命名规范、批量更新确认规则，以及成功提示词示例。upstream skill 有意保持最小化，因此最大的改进通常来自记录你们自己的 Spotlightr object naming、permission model 和 review process。