happy-scribe-automation

happy-scribe-automation skill 概览

happy-scribe-automation 能做什么

happy-scribe-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 运行 Happy Scribe 工作流。它可以帮助 agent 发现当前 Happy Scribe tool schemas、验证用户连接状态，并在执行转写、字幕、导出或项目管理操作时减少猜测，比通用 prompt 更可靠。

它的关键行为不是“假设 API 长什么样”。这个 skill 会明确要求 agent 先调用 RUBE_SEARCH_TOOLS，因为 Rube MCP 的 tool 名称、字段和执行计划可能会变化。

最适合 Workflow Automation 用户的场景

如果你已经在通过 MCP 使用 Claude，并希望把 Happy Scribe 任务嵌入更大的工作流中，例如处理已上传媒体、检查转写状态、导出字幕，或把结果交给另一个工具，那么这个 skill 很适合。对于需要反复执行内容运营流程、并希望 agent 在行动前先验证工具可用性的团队，它尤其有价值。

如果你只是偶尔需要一次转写，并且更愿意直接在 Happy Scribe 网页界面中操作，那么它的价值就没那么大。

这个 skill 的不同之处

最重要的差异点是“先发现、再执行”的模式。happy-scribe-automation skill 不会硬编码 Happy Scribe 操作，而是依赖 Rube MCP 返回当前 Happy Scribe toolkit schema、必填字段和潜在坑点。相比那些猜测 endpoint 名称或 request 格式的 prompt，这让它在自动化场景中更稳健。

安装前需要先确认的条件

安装前，请确认你的 AI client 支持 MCP servers，并且可以添加 https://rube.app/mcp。你还需要通过 RUBE_MANAGE_CONNECTIONS 使用 happy_scribe toolkit 建立有效的 Happy Scribe 连接。如果连接不是 active 状态，agent 必须暂停，并通过返回的授权流程引导你完成授权，然后才能运行工作流。

如何使用 happy-scribe-automation skill

happy-scribe-automation 的安装上下文

从 Composio skill collection 安装该 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill happy-scribe-automation

然后在你的 client 中配置 Rube MCP，添加以下 MCP server endpoint：

https://rube.app/mcp

上游 skill 只包含 SKILL.md，所以应先阅读这个文件。没有可检查的配套脚本、references 或规则文件夹。实际设置路径是：确认 RUBE_SEARCH_TOOLS 可用，针对 toolkit happy_scribe 运行 RUBE_MANAGE_CONNECTIONS，如有需要完成授权，然后再让 agent 执行 Happy Scribe 任务。

你需要提供哪些输入

为了稳定使用 happy-scribe-automation usage，请提供任务目标、媒体来源、目标语言、输出格式，以及任何截止时间或命名规则。如果你需要导出结果，请说明需要 transcript text、subtitles、captions，还是由发现到的 tools 返回的其他格式。

较弱的 prompt：

Transcribe this video with Happy Scribe.

更好的 prompt：

Use happy-scribe-automation for Workflow Automation. Discover the current Happy Scribe tools first, confirm my happy_scribe connection is ACTIVE, then create a transcription job for the uploaded Spanish interview. When complete, export an English transcript and SRT subtitles. Use the project name customer-story-q3 and tell me any fields you need before execution.

这样效果更好，因为它同时给出了目标、连接要求、语言和输出预期，以及执行前的权限边界。

推荐的工作流模式

一份好的 happy-scribe-automation guide 通常遵循四步：

1. 使用 RUBE_SEARCH_TOOLS 搜索与具体 Happy Scribe 任务匹配的 tools。
2. 使用 RUBE_MANAGE_CONNECTIONS 检查 happy_scribe 连接。
3. 只根据 discovery 返回的 schema 执行 tool。
4. 汇报 job IDs、状态、下一步动作，以及任何 export links 或缺失字段。

尽可能要求 agent 保持同一个 Rube session，这样 tool discovery 和执行上下文能保持一致。

提升结果质量的实用 prompt 技巧

明确说明任务类型是 create、monitor、update、list、export 还是 delete。Happy Scribe 工作流通常依赖 IDs、文件位置、language codes 和 export formats；如果你已经知道这些信息，最好一开始就提供。如果媒体尚未对 agent 可用，请先让它发现所需的上传方式或 source-field 选项，再尝试执行。

happy-scribe-automation skill 常见问题

没有 Rube MCP，happy-scribe-automation 够用吗？

不够。这个 skill 需要 Rube MCP，并依赖 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。如果没有连接 Rube MCP，agent 可以解释工作流，但无法可靠地执行 Happy Scribe 自动化。

为什么不直接让 Claude 使用 Happy Scribe？

普通 prompt 可能会编造字段、跳过身份验证检查，或假设旧版 API 行为。happy-scribe-automation 的价值在于，它会让 agent 在行动前先发现当前 tool schemas。这也是安装它而不是保存一个通用 Happy Scribe prompt 的主要原因。

这个 skill 适合新手吗？

如果你的 MCP client 已经正常工作，它对新手是友好的。难点不在 skill 本身，而在连接设置。新用户应先确认 RUBE_SEARCH_TOOLS 有响应，然后通过 RUBE_MANAGE_CONNECTIONS 连接 happy_scribe toolkit，最后再运行任务 prompt。

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

如果你的需求是人工编辑审阅、转写稿润色或翻译质量检查，除非这些步骤属于更大的自动化 prompt，否则不建议使用它。这个 skill 的设计目标是通过 tools 操作 Happy Scribe，而不是取代人工对转写准确性、说话人标签或字幕时间轴的审查。

如何改进 happy-scribe-automation skill 的使用效果

用约束条件改进 happy-scribe-automation prompts

提升 happy-scribe-automation 结果最快的方法，是在执行前说明约束条件：源媒体、语言、预期输出、项目命名、是否等待完成，以及当连接 inactive 时 agent 应该怎么做。这样可以减少 tool retries，并避免 agent 选择错误的 Happy Scribe 操作。

示例：

If transcription creation requires a file URL and I have not provided one, stop and ask me for it. Do not create placeholder jobs. Use discovered schemas only.

需要提前规避的常见失败模式

主要失败模式包括：跳过 tool discovery、使用过期字段名、在 Happy Scribe 连接 active 之前就运行，以及把 status polling 当成立即完成。对于创建或删除 job 这类高影响操作，应要求 agent 在执行前展示已发现的 tool 名称和必填输入。

根据第一次输出继续迭代

第一次运行后，让 agent 给出一份简洁的执行摘要：使用的 tool、输入字段、job ID、状态、导出格式和未解决问题。用这份摘要让下一次 prompt 更具体，例如请求另一种导出格式、监控已有 job ID，或对多个媒体文件应用一致的命名规则。

谨慎扩展工作流

如果要做更广泛的自动化，请在 Happy Scribe 步骤稳定之后，再把这个 skill 与文件存储、发布或通知工具串联起来。一个安全模式是：先在 Happy Scribe 中转写或生成字幕，验证输出可用，完成导出，然后把结果传给下一个工具。每一次交接都要写清楚，避免 agent 混淆转写创建、状态检查和下游交付。