技能

Showly 技能

技能作为代理功能的用户可见界面。

Showly 发布了官方 Claude Code 技能，用面向任务的提示封装了 MCP 服务器。该技能是从代理使用Showly的最简单方法：安装它，代理会自动知道何时调用Showly工具，并且提示已经对发布循环约定进行了编码。

为什么是技能

原始 MCP 服务器为代理提供工具。技能教会代理_何时_以及_为什么_使用它们。 Showly技能包括：

  • 根据意图触发的描述（“部署”、“发布”、“预览”、“炫耀”）。
  • 链接 create_change_plan → apply_site_patch → create_preview → run_checks → request_publish 的内部脚本，因此代理不必这样做。
  • 读取预览 URL 并返回报告的验证步骤。
  • 代理不应自行采取的操作的拒绝模式（生产发布总是通过批准门发送给人类）。

安装官方Skill

在Claude Code（或Codex）中：

npx @showly/mcp-server install --to claude-code   # or --to codex

此命令会从 @showly/mcp-server 软件包安装并注册 Showly MCP 服务器。无需手动配置令牌：首次调用 Showly 工具时，智能体会打开浏览器，让你登录并授权访问；随后 Showly 会通过标准 MCP OAuth 直接向智能体签发带作用域的令牌。完整握手流程和无浏览器环境的备用方式见安装技能。

原始 MCP 不具备的技能有哪些

  • 通过将存储库的 GitHub 远程位置与 Showly 工作区中的站点进行匹配，自动发现当前工作目录中的活动站点。
  • 如果还安装了 Playwright MCP，则 渲染内联预览 以及 mcp__playwright_browser_take_screenshot 的屏幕截图。
  • 拒绝在没有最近通过预览的情况下请求发布；生产发布总是经过 request_publish 和人工批准。

自动发现

当您在签出的存储库中运行代理时，技能会读取存储库的 origin 远程并在工作区中查找 repositoryUrl 匹配的站点。匹配站点的 siteId 成为 get_site_context、apply_site_patch、create_preview 以及循环其余部分的目标，因此您很少需要手动命名站点。

如果没有站点与遥控器匹配，该技能会要求您选择或创建一个站点，而不是猜测。如果多个站点共享遥控器，它会要求您消除歧义。

发布护栏

作品绝不会直接由代理商发布。在请求发布之前，技能会检查：

  • 该站点最近有一个 ready 预览部署。
  • run_checks 已通过该预览。

当这些成立时，技能会调用 request_publish，它会返回 webApprovalUrl 深层链接。具有管理员权限的人员在 Web UI 中批准该请求；代理仅轮询批准状态。如果没有人工步骤，就没有代理路径可以促进生产。

下一步