SuperAPI AI 工具集

create

编程与开发

查看项目

更新于 10-16 05:33

技能介绍

用途

create 是一个“薄路由”技能,用于创建新项目。它自身不包含任何技术栈相关的脚手架逻辑,也不直接生成项目文件,而是负责把项目创建请求路由到正确的配套插件,由该插件的项目创建技能完成实际工作。

主要能力

  • 扫描推荐文件:使用 Glob 查找 Wingspan 插件根目录下 hooks/recommendations/ 中的所有 *.json 文件,并逐个读取。每个推荐文件的结构为:plugin(插件名)、description(插件提供的功能说明)、marketplace(所属市场,格式为 OrgName/repo-name)。
  • 匹配插件:将用户的项目描述与各推荐条目的插件名和描述进行不区分大小写的比较,选择描述最匹配所请求技术的插件。若没有匹配项,则告知用户该类型项目没有注册配套插件并停止;若有多个匹配,则选择最具体的一个。
  • 校验安装状态:检查对话上下文中 system-reminder 列出的可用技能,看是否存在以匹配插件名加冒号前缀的技能。若没有,说明插件未安装,此时通过 AskUserQuestion 询问用户是否安装。
  • 引导安装:若用户选择安装,输出 /plugin marketplace add <marketplace> 和 /plugin install <plugin> 两条命令并停止,提示用户运行后以相同的项目描述重新调用 /create。
  • 委派创建:在可用技能中查找以匹配插件名为前缀的技能,挑选名称或描述最符合项目创建含义(如包含 create、scaffold、new project、generate、init 等词)的技能,使用 Skill 工具以完整限定名(例如 my-plugin:scaffold-project)调用,并把用户完整的项目描述作为参数传入。

使用方式

调用 /create 并附带项目描述(对应 $ARGUMENTS)。如果描述为空,技能会先扫描推荐文件发现可用的项目类型,然后通过 AskUserQuestion 提问“What kind of project would you like to create?”,选项由已发现的配套插件描述构成,并附加“Other”作为最后一项;在获得项目描述之前不会继续执行。所有面向用户的问题都必须使用 AskUserQuestion 工具。

适用场景

适用于希望通过统一入口创建新项目、且项目类型由已注册的配套插件支持的场景。用户只需描述想创建的项目,由该技能负责找到并调用对应的创建技能。

限制

  • 不自行搭建项目,所有实际创建逻辑都在配套插件中。
  • 若没有匹配的配套插件,或匹配到的插件未提供项目创建技能,则流程停止并告知用户。
  • 若技能调用失败,会向用户显示错误,并建议确认配套插件是否正确安装。
  • 插件未安装时,需要用户手动执行安装命令并重新调用 /create,技能本身不会继续执行后续步骤。

补充说明

该技能的定位是路由层,不含任何技术栈特定逻辑。关于具体支持哪些项目类型,取决于 hooks/recommendations/ 下实际存在的推荐文件,资料中未提供具体清单。