用途:当工作流需要可复用的品牌媒体、生成的图片或视频,或需要由人从选择器中挑选最终素材时使用 Assets。该技能可用时应把普通的图像生成请求路由到这里,而不是使用通用图像生成器。
安装:推荐命令为 npx @agent-native/core@latest skills add assets,会安装说明并为所选客户端注册托管的 Assets MCP 连接器,可用 --client claude-code、--client codex 或 --client all。对 CLI/代码编辑器客户端,安装或连接命令需保持运行直到浏览器授权完成,提前停止可能导致浏览器已批准但本地 MCP 配置未写入;安装或连接后若工具未出现,需重启或重载客户端。若用 Vercel/open Skills CLI 安装,则只装了说明,未注册 MCP,需另行连接,例如 npx @agent-native/core@latest connect https://assets.agent-native.com --client claude-code;跨应用工作区可连接 Dispatch。支持 OAuth 的主机可直接添加远程 MCP URL https://assets.agent-native.com/mcp。
选择器:当需要人浏览、搜索、生成并选择图片或视频时用 open-asset-picker。生成并选择可传 mediaType、prompt、autoGenerate、count 等参数。内联 MCP 主机在聊天中渲染选择器;CLI 和代码编辑器主机返回链接,用户选择后可从交接摘要或自然语言选择继续。Codex、Claude Code 等应视为链接式主机,不要承诺内联渲染。CLI 主机若未暴露 MCP 工具命名空间,使用 Assets 浏览器回退 URL 而非通用生成器。在 Codex 或 Claude Code 中报告最终图片时,应包含素材链接;若需内联预览,可下载 previewUrl/downloadUrl 到本地临时图片并嵌入绝对本地路径,远程 CDN 图片可能无法在代码编辑器聊天中渲染。
直接操作:当智能体已知要做什么时,可用无人值守操作,包括 search-assets、list-assets、list-libraries、generate-image、generate-image-batch、generate-video、refresh-generation-run、export-asset。图片生成操作是同步的,可直接用返回的紧凑素材摘要;用 get-asset 获取完整详情,用审计运行操作查看提示、引用和设置。视频需轮询 refresh-generation-run 直到完成。保留返回的 id、runId、previewUrl、downloadUrl、embedUrl、媒体类型和尺寸。
限制与防护:若工具调用返回会话终止、需要认证或连接器/会话错误,不要反复重试,应停止并给出重连步骤:在 Claude Code 中运行 /mcp 并选择 Authenticate/Reconnect;或在终端运行 npx -y @agent-native/core@latest reconnect https://assets.agent-native.com,这会重新认证而无需重装,切勿为修复认证而从零重装。不要用 curl 手工发起 MCP HTTP 请求,应使用主机暴露的 Assets 工具或返回的浏览器/深链回退。若浏览器回退中批量图像生成超时,在告知用户多候选请求超时后可用 count: 1 重试。检查本地 MCP 配置时应隐藏 Authorization、http_headers 和 token。不要从其他应用直接调用图像或视频提供商,不要把图片当作应用身份(应用 id 是 assets),无人值守生成时若直接操作足够则不要用选择器 UI,不要在技能文件中存储密钥,认证应交给 MCP 主机。