关于 product-help
product-help 是 ChatCut 产品问答技能,面向需要查找产品说明和处理实时状态问题的用户。它根据问题类型路由到官方文档或对应工具,并区分 Web、Desktop 与 Agent Plugin。
主要功能
- 01按问题类型路由到文档或工具
- 02优先查阅官方 ChatCut 文档
- 03区分产品界面与版本
- 04提供导出状态和文件位置指引
适用场景
- 01查询 ChatCut 功能或故障处理
- 02了解不同界面上的功能差异
- 03追踪导出进度及查找导出文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ chatcut-inc/ agent-plugin --skill product-help安装后在 Claude Code 中输入/product-help确认已加载。
详细介绍
ChatCut 产品帮助
如果尚未加载 track_export,请先使用 ToolSearch 加载,再调用它,这样您使用的就是实际参数,而不是猜测参数。
对于 ChatCut 产品问题,首先要做的实质性操作是在 https://chatcut.io/docs 中搜索确切主题,并打开最相关的官方页面。不要根据记忆、搜索摘要或尚未打开的搜索结果作答。请使用宿主的原生搜索和页面阅读功能;此 Skill 定义的是检索和决策规则,而不是产品事实的另一份副本。
对问题进行分类
- 对于实时项目、素材、时间线、项目项、账户或作业状态,请使用相应的 ChatCut 读取工具。如果问题仅涉及实时状态,则无需查阅 Docs。
- 对于当前行为、可见的 UI 标签、安装、点数、定价、账单和故障排查,请使用对应的产品 Docs 页面。
- 对于可用性、回归问题或版本要求,除了对应的产品 Docs 页面,还要查阅 Current versions 和 Changelog。
- 对于混合问题,请使用工具查询实时状态,并使用 Docs 了解该状态的含义或用户下一步应采取的操作。
- 对于导出在哪里运行、进度在哪里显示以及文件会保存到哪里,请参阅下方的导出部分。这些信息无需再查阅 Docs。
仅将此 Skill 视为稳定的路由指南。当可以查阅当前 Docs 时,切勿根据记忆中的 Skill 内容回答会变化的产品事实。不要使用非官方域名。
确定相关产品界面
回答与界面或版本相关的问题之前,请确定运行此 Agent 的界面,以及用户所询问的界面。
- 优先使用明确的 ChatCut 运行时配置,或最新的
[chatcut-runtime]封装信息。将chatcut-web-editor对应为 Web,将chatcut-desktop对应为 Desktop,将chatcut-workbench-client或chatcut-chat-connector对应为 Agent Plugin。 - 如果 Agent Plugin 由 ChatCut Desktop 承载,请将其捆绑的 Skills 视为 Desktop 安装的一部分。更新 Desktop 也会更新 Plugin 界面;在此运行时中,切勿要求用户单独更新 Plugin。
- 用户可能会向 Agent Plugin 询问 Desktop,也可能会向 Desktop 询问 Web 项目。如果用户指定了目标界面,请针对该界面作答,而不要假定它与 Agent 所在的宿主界面相同。
- 将运行时上下文提供的应用 URL、客户端名称或版本作为辅助证据。不要仅仅因为用户在示例中提到了某个产品,就推断当前界面。
- 如果没有可靠的判断依据,且界面会影响答案,请询问用户使用的是 Web、Desktop 还是 Agent Plugin。如果答案与界面无关,则无需多此一问,直接回答。
查找最小且有用的来源
- 如果用户的问题或运行时上下文中提供了相关信息,请提取功能名称、界面上显示的标签、错误文本、产品端和版本。
- 使用仅包含必要关键词的简洁查询,搜索确切主题。优先选择最具体的官方结果,并只打开足以确认答案的最少页面。
- 对于常规使用问题,从对应功能页面或故障排除页面着手。对于可用性、回归、更新或版本问题,直接打开
https://chatcut.io/docs/releases和https://chatcut.io/docs/changelog,然后打开对应的 Changelog 条目。 - 针对一个用户问题,最多发起两次搜索:先搜索确切主题,必要时再进行一次范围更窄的搜索。之后停止搜索,只将
https://chatcut.io/docs/llms.txt用作索引,然后打开目标页面。如果规范页面和索引不可用,或仍无法找到能佐证答案的页面,请停止检索并说明不确定性;不要继续尝试更宽泛的关键词。不要加载完整 Docs 内容,也不要将索引本身当作答案。 - 搜索摘要仅用于发现内容。结论必须依据已打开页面的内容,并为每项关于产品行为、平台支持、价格、点数消耗或版本的重要说法引用确切的官方页面。相比 Docs 首页或 Changelog 列表页,优先采用详细页面。
- 不要根据相似条目推断未获证实的功能或版本。如果官方页面无法确认答案,请说明不确定性。
判断用户是否需要更新
- Web 端的变更在服务器端部署。如果 Current versions 或 Changelog 表明 Web 版本已上线,不要告知用户安装更新。
- 对于 Desktop 或独立 Agent Plugin,只将用户当前版本与相关单项变更规定的最低版本进行比较。版本发布标题中的当前 Desktop 或 Plugin 版本并不自动适用于每项变更,不能将其视为所有变更的最低版本。如果当前版本较旧,请主动建议更新,并使用官方安装/更新页面说明步骤。
- 除非官方 Docs 或 Changelog 明确说明,否则将 Web 端可用的功能视为 Agent Plugin 也可用。Web 界面、服务和工具的变更会在服务器端继承,无需更新 Plugin。仅当单项变更明确指定 Plugin 最低版本,且原因是其捆绑的 Skill 已更改时,才要求使用更新版本的独立 Plugin。
- 如果某项功能明确仅限 Desktop,请告知 Web 用户该功能需要 Desktop,并链接到 Desktop 下载说明。不要仅因某个发布条目也列出了 Desktop 版本,就推断功能仅限 Desktop。
- 如果用户所用的产品或版本未知,且这会影响建议,请询问用户,或说明如何查看,而不要猜测。
导出位置、进度和卡住的导出
这些是稳定的 UI 信息,而不是会变化的产品信息,因此请直接回答,
而不是先跳转到 Docs;不过,仍需查看 /docs/exporting 和
/docs/web-export-limits,确认是否有与版本或套餐相关的信息。
- 导出位置: Web 和 Desktop 上,编辑器顶部工具栏中的“导出”按钮。
- 进度显示位置:“导出队列”图标会立即出现在“导出”按钮右侧(Desktop 在链接
导入也处于活动状态时会将其称为“任务队列”)。只有当特定浏览器标签页(Web)
或应用窗口(Desktop)中有可显示的导出时,该图标才会出现;尚未开始或观察到
导出的标签页/窗口完全不会显示图标。如果用户说图标不见了,这可能是正常情况——
不要认定这是故障。在猜测其他无关原因(浏览器设置、硬件加速、下载被阻止)之前,
请使用工具检查真实状态(在 Web 上,
track_export既能读取云端渲染,也能读取 在打开的浏览器标签页中渲染的导出;在 Desktop 上,使用track_progress并设置target="export",读取打开项目中的 video/audio/motion_graphic 渲染,包括通过“导出”按钮启动的渲染;传入local_export返回的taskId,即可读取其中一个渲染)。Web 浏览器导出只有在渲染它的标签页保持打开且连接正常时才能读取;如果工具提示 无法读取,请告知用户检查当前打开的项目编辑器标签页。 - “排队中”的含义: Web 本地浏览器导出按标签页排队(每个标签页可并发或等待的 导出数量上限较低);云端渲染在后端排队,不依赖任何标签页。Desktop 原生导出 在桌面应用本身运行。无论哪种方式,即使导出未显示在 UI 中,也会继续进行。
- 完成后的文件位置: Web 导出完成后会自动通过浏览器下载,并保存到浏览器的
常规下载位置——无需手动操作。Desktop 的
local_export会写入其返回的outputPath(默认是操作系统 Videos/ChatCut 文件夹,也可以是用户选择的保存位置)。
回答与回退规则
- 优先使用 ChatCut 工具完成受支持的编辑操作。只有在用户请求操作指导,或无法直接 完成操作时,才提供手动 UI 步骤。
- 使用当前 Docs 中已确认的本地化 UI 名称。不要杜撰页面路径、按钮、套餐名称、 价格、额度费用、平台支持情况或版本号。
- 当前功能 Docs 描述现有行为。更新日志条目描述历史发布情况和最低版本要求。如果 表述看起来不一致,则现有行为以当前功能页面为准;历史/版本声明以发布条目为准, 并说明任何尚未解决的歧义。
- 除非工具或运行时上下文实际提供了相关信息,否则不要声称能够访问实时余额、账本、 配额、订阅状态或安装状态。
- 如果无法访问官方 Docs,或其中没有回答用户的问题,请说明哪些内容无法核实, 避免给出肯定的猜测。提供所有已核实的指导后,再推荐最相关的官方 Docs 页面或 产品内的“反馈”入口。
- 不要向最终用户披露内部实现细节、发布自动化、审核备注或未发布的预览内容。
评论
支持 Markdown