SuperAPI AI 工具集

run-skill-generator

智能体与模型

查看项目

更新于 10-24 16:21

技能介绍

该技能的核心用途:为项目中的一个可部署单元(<unit>)生成运行技能,放在 <unit>/.claude/skills/run-<unit-name>/ 目录下,使未来的智能体能够从干净机器上构建、启动并驱动该项目。技能通常由两部分组成:SKILL.md(面向智能体的简短说明,指向驱动)和驱动脚本(driver.mjs、driver.py、smoke.sh 等;Web 应用可直接使用 chromium-cli,此时 SKILL.md 内嵌的脚本即为驱动)。

主要能力:发现或定位项目单元;调研 README、package.json、Dockerfile、Makefile、CI 配置等;实际安装、构建、启动应用;构建可编程交互驱动(桌面 GUI 用 REPL + tmux,Web 应用用 chromium-cli,服务器用 curl,库用导入调用脚本);完成一次真实用户流程并截图;编写 SKILL.md;最后在新 shell 中逐行验证。

使用方式:技能按流程分四步:0)查找已有运行技能,有则修正而非重写;1)发现并质疑文档中的每条声明;2)实际执行并构建所需驱动,遇到问题记录到 NOTES.md;3)编写 SKILL.md,包含前置依赖、构建、智能体运行路径、人类运行路径、注意事项与排错;4)新 shell 中逐行验证。

适用场景:需要为 Web 服务器/API、CLI 工具、TUI、Electron/桌面 GUI、浏览器驱动应用或库/SDK 生成可执行的运行说明与驱动脚本时。

限制:强调只记录实际运行并验证过的命令;不写未运行的命令或未验证的平台说明;不为交互式应用只写文字说明而无驱动;Web 应用可直接内嵌 chromium-cli 脚本,桌面应用需编写 REPL 驱动并在 xvfb/tmux 下运行。技能要求保留驱动为交付物之一,SKILL.md 作为其使用说明。