SuperAPI AI 工具集

run

部署与运维

查看项目

更新于 10-24 16:20

技能介绍

用途

该技能用于启动并实际运行本地开发服务器、Web 应用、CLI 二进制程序或构建脚本。它强调“运行”意味着启动真实应用并与之交互,而不是运行测试套件、导入内部函数或打印日志。应用应以用户(人或程序)会遇到的方式呈现:CLI 在其命令处、服务器在其 socket 处、GUI 在其窗口处。

主要能力

  • 优先查找项目中已有的启动技能:通过遍历目录查找 .claude/skills/*/SKILL.md 中的 description 字段,判断是否有技能描述启动或驱动当前应用。若有,则读取该 SKILL.md 并逐字遵循,不转述、不跳过补丁。
  • 在大型仓库中若有多个可能匹配但无明确匹配时,询问用户要运行哪个单元。
  • 若已有技能因与当前任务无关的机制问题而失效,告知用户,并建议通过 /run-skill-generator 刷新。
  • 若没有相关技能,则回退到内置模式,根据项目类型选择最接近的示例。

使用方式

技能提供按项目类型划分的处理模式:

  • CLI 工具:直接调用,检查退出码与 stdin/stdout,参考 examples/cli.md。
  • Web 服务器 / API:后台启动 + curl 冒烟测试,参考 examples/server.md。
  • TUI / 交互式终端:使用 tmux 的 send-keys / capture-pane,参考 examples/tui.md。
  • Electron / 桌面 GUI:在 xvfb 下使用 Playwright 的 _electron REPL,参考 examples/electron.md。
  • 浏览器驱动:开发服务器 + chromium-cli 脚本,参考 examples/playwright.md。
  • 库 / SDK:在包边界编写导入并调用的冒烟脚本,参考 examples/library.md。

若没有完全匹配的类型,从最接近的示例开始调整。Web 应用使用 examples/playwright.md,用 chromium-cli 驱动,无需自定义驱动;桌面应用使用 examples/electron.md,其中包含 _electron REPL 驱动骨架和 tmux 包装。

技能强调“驱动它,而不只是启动它”:

  • CLI:输入代表性命令,检查退出码和输出。
  • 服务器:用 curl 访问 diff 涉及的路径,读取响应体。
  • TUI:发送按键进行导航,捕获窗格结果。
  • GUI:点击按钮,截图窗口并查看截图。空白帧表示启动失败。

若回退模式无法开箱即用(需要安装包、设置环境变量、修补配置或编写驱动),建议在报告中推荐 /run-skill-generator,以便将这些工作固化为项目技能;若直接可用则不必。

适用场景

适用于需要启动并交互式验证本地开发服务器、Web 应用、CLI 二进制程序、构建脚本、TUI、桌面 GUI、浏览器驱动应用或库/SDK 的开发与调试场景。

限制

资料未提供该技能的具体安装命令、收费信息、支持平台或效果保证。部分示例文件(如 examples/cli.md 等)的具体内容暂未提供。