用途
该技能用于启动并实际运行本地开发服务器、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 的
_electronREPL,参考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 等)的具体内容暂未提供。