mcpField
A
aip-setup

aip-setup

github.com/opus-pro创意与媒体7126 次安装4 天前更新
代码仓库

关于 aip-setup

aip-setup 是帮助用户从初次连接到创建首个 AI Producer 项目的设置技能,适用于准备开始视频编辑的用户。它确认连接、收集视频与目标,并在项目开始后交接;编辑工作由其他技能负责。

主要功能

  1. 01检查并确认 AI Producer 连接
  2. 02按客户端指导账户连接
  3. 03收集视频和编辑目标
  4. 04读取价格后提交视频附件
  5. 05项目启动后提供后续入口

适用场景

  1. 01首次连接 AI Producer
  2. 02从聊天附件创建视频项目
  3. 03在新会话中继续未完成的设置

MCP 相关

技能通过 AI Producer 工具操作,包括 get_pricing 和 start_project_from_attachment;AI Producer 服务器通过 MCP 连接。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/opus-pro/ai-producer-plugin --skill aip-setup

安装后在 Claude Code 中输入/aip-setup确认已加载。

附带文件agents/openai.yaml

详细介绍

设置 AI Producer

此技能会帮助用户从全新安装开始,创建一个真正的 AI Producer 项目,然后停止。首次成功的标志是 AI Producer 已接受项目并开始准备,而不是编辑好的视频。之后的剪辑、字幕和动态图形都属于 aip 技能。

可以安全地重复运行。每次都从步骤 1 开始,跳过已完成的部分。在新聊天中,“继续设置 AI Producer”会从用户上次停下的地方继续:已成功连接时跳过步骤 1 和 2;本次对话已启动项目时则直接跳到步骤 6,并继续处理该项目。

按照 aip 技能的“与用户沟通”部分与用户交流:使用他们的语言,围绕他们的账户和视频交流,绝不提及工具、服务、代码或此技能。

你所处的对话类型

在步骤 1 之前,只需判断一次。只要可以在对话背后的计算机上运行命令或写入文件,这段对话就具备计算机访问能力:ChatGPT Work、Codex 和 Claude Code 始终如此;Cursor 在命令或文件工具可用时也具备此能力。ChatGPT Chat 对话则不具备:用户在其中附加的视频由宿主持有,并不是你能访问的文件。

  • 具备计算机访问能力时,按原样执行步骤 1 到 3。然后交接:将用户的视频和目标直接带入 aip 技能的新建项目流程,由该流程上传视频、启动项目并继续编辑。以下步骤 4 到 6 不适用;不要在那里使用附件工具。
  • **无法访问命令或文件的 Cursor:**告诉用户,此聊天需要访问他们的视频文件和编辑工作区。请他们切换到已启用命令和文件访问权限的 Agent 模式,然后继续设置。此访问权限可用之前,请停在这里;不要在 Cursor 中使用仅限附件的 ChatGPT 流程,也不要使用 start_project_from_attachment。
  • **没有计算机访问能力的 ChatGPT Chat:**需要执行全部六个步骤。视频只能作为附件传给 AI Producer,由服务通过 start_project_from_attachment 下载。绝不要让用户运行命令、打开终端,或从你的计算机上传文件,也不要签署上传。

1. AI Producer 是否已连接?

不带参数调用 get_pricing。该调用免费,不会读取任何项目数据,但需要已登录的连接,因此可用于检查。保留其回答,步骤 4 会读取。

  • **如果返回价格表:**连接正常。用一句话说明,然后进入步骤 3。
  • 如果工具列表中没有 AI Producer 工具,或调用因需要登录而被拒绝(回答或宿主提示连接需要登录、没有凭据,或凭据已过期、已撤销或无法识别):账户尚未连接。进入下方的连接步骤。
  • 如果调用因其他原因失败(服务无法访问、网络错误、超时或服务器故障):这不是登录问题,重新登录也无法解决。告诉用户,AI Producer 暂时无法访问,他们的账户和视频都没有问题。最多再检查一次;如果仍然失败,请他们几分钟后重新尝试设置。不要引导他们登录。
连接账户

将此客户端连接到 AI Producer 是一个独立步骤。在 AI Producer 网站上登录,并不会连接 ChatGPT、Codex、Claude Code 或 Cursor;连接它们也不需要先访问网站:连接流程会打开 AI Producer 自己的登录页面。已有账户的用户在该页面登录;新用户则在该页面创建账户。

只有用户本人才能在自己的客户端中完成连接。请根据他们使用的客户端说明此步骤:

  • **ChatGPT(Chat 或 Work):**ChatGPT 提示连接 AI Producer 时,选择 Connect 并完成登录。如果没有提示,请通过 Settings > Apps & Connectors 连接或重新连接 AI Producer,并在那里完成登录。
  • **Codex:**让用户在自己的终端中运行 codex mcp login ai-producer 并完成登录。Codex 桌面应用也一样;它没有专门用于插件连接的登录控件。你运行的命令不会访问网络,因此无法代替他们完成。
  • **Claude Code:**运行 /mcp,选择 plugin:aip:ai-producer,并完成登录。
  • **Cursor:**打开 Customize > MCPs > ai-producer > Authenticate 并完成登录。使用 Cursor 自带的连接控件,不要使用 Codex 或 Claude Code 命令。

单独安装的技能(例如使用 npx skills add 安装)不包含 ai-producer 服务,因此没有可供登录的内容。如果用户在上述步骤指定的位置找不到 AI Producer 服务,让他们在自己的终端中添加一次:Claude Code 使用 claude mcp add --transport http --scope user ai-producer https://producer.opus.pro/api/mcp,之后 /mcp 会将其列为 ai-producer;Codex 使用 codex mcp add ai-producer --url https://producer.opus.pro/api/mcp;其他客户端则在各自的 MCP 设置中添加一个名称为 ai-producer、URL 为该地址的 HTTP MCP 服务。然后让他们开始新的聊天,按上述步骤登录,并在新聊天中说“继续 AI Producer 设置”。

如果拒绝操作时附带了专门的恢复说明,请用通俗的话转述其含义,并一并提供此步骤,因为这些说明是针对发起调用的客户端编写的。不要构建授权链接,不要建议重新安装插件,也不要更改现有的 MCP 配置:这些都无法连接账户,而且可能破坏正常运行的安装。然后请用户在完成后告知你,并等待。

2. 确认连接

用户表示已完成连接后,再次调用 get_pricing。只有它的答复才算数:用户说自己已登录不代表已连接,网站显示用户已登录也不代表已连接。

  • **返回价格表:**用一句话告知用户 AI Producer 已连接,然后进入第 3 步。
  • **仍因登录问题遭到拒绝:**登录尚未完成。再说明一次同样的步骤,并且只补充拒绝信息中提到的变化,例如登录已过期,或账户无法使用 AI Producer。最多再询问一次;之后告知用户设置已暂停在连接环节,并且说“继续 AI Producer 设置”即可恢复。
  • **工具仍未出现在你的工具列表中:**此对话没有获取到新的连接。请用户开始新的聊天,并在其中说“继续 AI Producer 设置”。
  • **任何其他失败:**按第 1 步处理。登录后发生失败,不代表需要再次登录。

3. 视频和目标

用一条简短消息询问两项内容:一个附加到对话中的视频,以及一句说明他们想通过视频实现什么的描述,例如制作带字幕的 60 秒精彩片段。如果对话中已有视频和目标,就直接使用,不要询问。如果已有其中一项,只询问另一项。

接收信息到此为止。此处不要询问风格、字幕、音乐、品牌元素或参考图片:开始编辑时,aip 技能会处理这些内容。每个项目只能有一个视频;如果用户附加了多个视频,请询问要先处理哪一个。

4. 提交前

视频是否可用由服务决定:提交时会检查视频的格式、时长和大小限制;如果拒绝,会说明未通过哪项检查。不要自行测量、转码或质疑视频,也不要凭记忆引用限制。

起始费用应以你保留的 get_pricing 答复为准,绝不能凭记忆估算:查看 start_project_from_attachment 行以及计费详情。遵循 aip 技能的定价规则。如果启动项目会向这位用户收费,请在提交前用通俗的语言告知其准备视频的费用,以及服务会测量视频时长并据此定价;如果每日额度可能会先覆盖费用,也要说明。如果免费,则不要提钱。

5. 提交

调用一次 start_project_from_attachment:

  • file:用户在本次对话中附上的视频。由宿主填入;绝不要自行编写文件对象,也不要重用之前尝试中的文件对象。
  • prompt:用用户自己的话描述其目标。
  • aspect_ratio:仅当用户要求时填写。

该调用会先下载完整视频,然后才会答复,因此可能需要一些时间。请等待。如果答复中同时包含 project_id 和 task_id,才表示项目已创建;在此之前,不要提及项目。

被拒绝时,根据拒绝原因处理一次,不要原样重复相同调用:

  • 无法下载附件(没有收到文件,或其地址被拒绝):重发相同调用也会以相同方式失败。告知用户两种解决方法:在网页版 ChatGPT 中重新附上视频,或在 AI Producer 网站上传视频并在那里继续。
  • **视频格式不受支持、时长过长或文件过大:**按拒绝答复中的说法指出具体原因,并请用户提供符合要求的视频。
  • **积分、免费使用额度或当日项目数量限制:**说明额度用尽的项目以及重置时间;如果拒绝答复中附有充值或升级链接,也一并提供。未收取任何费用。
  • **系统繁忙,或下载中断且标记为可重试:**等待拒绝答复指定的时间,然后再试一次。若再次失败,按附件无法下载的情况提供相同的两种解决方法。
  • **连接需要重新登录:**返回步骤 1 中的连接步骤。
  • **其他任何拒绝:**告知用户项目未启动且未收取任何费用,除非拒绝答复另有说明,并表示可以稍后重试。

如果调用因超时或连接断开而结束,完全没有收到答复,这不算拒绝:项目可能已经启动。不要再次调用,也不要说调用失败或未收取费用。使用 list_projects 查找;如果其中出现了自提交后创建的、对应此视频的项目,就以该项目为准,继续执行步骤 6 并提供项目链接。如果暂时没有,则告知用户启动请求可能仍在处理中;处理完成后,AI Producer 网站会显示该项目。用户要求重试时,再用 list_projects 查找一次;如果仍未找到,告知用户,如果之前的启动请求已成功,再次提交会创建第二个项目,也可能再次收费;只有在用户了解这一点并明确同意后,才重新提交。

6. 交接

答案中包含项目后,请按以下顺序告知用户:

  1. 他们的项目位于 AI Producer 中,视频正在准备。视频尚未剪辑:准备素材是剪辑前的第一步。
  2. 项目链接,即答案中的 page_url,必须与返回内容完全一致。该链接归他们所有,可在任何浏览器中使用。绝不要提供 agent_page_url。
  3. 告知他们接下来该怎么做。剪辑、字幕和动态图形需要通过电脑上的对话来完成:使用 ChatGPT Work 聊天、Codex 任务,或配备命令和文件工具的 Claude Code 或 Cursor 聊天。他们需要启动对话,提及 AI Producer,并粘贴项目链接;素材已经在 AI Producer 中,无需再次附加。

之后,设置便已完成。不要在此对话中再次调用此技能。如果用户询问准备进度,请使用 get_task 查看,并根据其内容作答。

评论

支持 Markdown