SuperAPI AI 工具集

run-skill-generator

智能体与模型

查看项目

更新于 10-15 17:19

技能介绍

用途:为某个可部署单元(应用、服务、库)编写或改进 run-<unit-name> 技能,让未来的智能体在干净机器上也能构建、启动并驱动该项目。技能存放在 <unit>/.claude/skills/run-<unit-name>/,由两部分组成:面向智能体的简短 SKILL.md,以及驱动脚本(driver.mjs、driver.py、smoke.sh 等)。Web 应用可直接使用现成的 chromium-cli,此时 SKILL.md 内的 heredoc 即脚本;无独立文件也可。

主要能力与做法:先查找项目中已有的同类技能,若有则验证并修正而非重写;同时检查遗留的 .claude/run.md 并迁移。随后勘察 README、包脚本、Dockerfile、Makefile、CI 配置等,把文档中的声明视为可推翻的假设,尤其是否定式声明(如仅支持某系统、需要 GPU 或付费账号),在 Linux 无头容器中实际尝试启动。接着实际安装、构建并启动真实应用而非测试套件,搭建能程序化输入与观察输出的驱动(服务端用 curl,TUI 用 tmux 的 send-keys/capture-pane,桌面 GUI 用 xvfb 下的 _electron REPL 驱动,浏览器应用脚本化 chromium-cli),完整走通一条真实用户流程并截图确认。驱动与技能一同提交,默认位于技能目录内;若项目测试套件需要复用,可迁移到 scripts/ 或 e2e/ 并更新 SKILL.md 引用。

使用方式与限制:SKILL.md 需保持简短,指向驱动;frontmatter 的 name 即斜杠命令,description 要含 run、start、build、test、screenshot 等实际动词以触发自动加载。正文包含前置依赖、构建、智能体路径、人工路径、Gotchas、Troubleshooting。技能路径相对 <unit>/ 表述,目录名小写加连字符。完成后在全新 shell 中逐行验证。仅收录实际运行过的命令,不写未验证内容、不列举全部选项、不写通用排错;具体命令与工具多数以示例形式给出,资料未提供完整固定模板,实施细节需结合项目自身判断。