SuperAPI AI 工具集

scaffold-new-skill

智能体与模型

查看项目

更新于 10-16 07:59

技能介绍

用途:该技能(meta-skill)为 agent-skills 仓库生成符合规范的 skills/<name>/ 新技能包骨架。生成的所有文件都满足 pnpm validate:skills 强制执行的同一套规则(ADR-0001、A-364),新建技能落盘即有效。

主要能力:根据 kebab-case 的 --name=<name> 生成 SKILL.md(含 name、metadata.version 0.1.0、metadata.author 及 ## Process / ## Scripts 主体骨架与 TODO 占位)、package.json(name 为 <scope>/skill-<name>、private: true、version 0.1.0、repository.directory 为 skills/<name>)、config.json 与 config.example.json(由同一模板生成,键集合天然一致)、scripts/<name>.mjs(零依赖入口脚本,内置 --help / --dry-run / --self-test 调度惯用法,导出纯 run() 并有 isCliEntry() 守卫)、README.md,以及 tests/skills/<name>/<name>.test.ts(vitest 桩)。

配置:同目录 config.json 有两个默认值,scope 用于生成包名,author 为写入 SKILL.md 与 package.json 的默认作者;另附带键集合相同的 config.example.json 模板。可用 --author="…" 按次覆盖作者。

使用方式:1) 选名,小写 kebab-case([a-z0-9-],首尾及连续连字符不允许,≤64 字符),不符合会在写入前被拒绝;2) 先用 node skills/scaffold-new-skill/scripts/scaffold.mjs --name=<name> --dry-run 预览将写入的文件与路径;3) 去掉 --dry-run 实际生成,若 skills/<name>/ 已存在且含内容则拒绝覆盖;4) 以 pnpm validate:skills && pnpm test 确认校验通过;5) 填写 TODO 占位内容,并按仓库手工版本规则同步提升 package.json 与 SKILL.md 的版本。脚本支持 --help/-h、--dry-run、--self-test(在临时目录做离线断言:名称校验、生成骨架通过校验规则、config 与 example 键一致、dry-run 不写入、真实写入与拒绝覆盖守卫),无网络访问,临时目录外不写入。

适用场景与限制:适合在 agent-skills 仓库内快速规范化创建新技能包。仅服务于该仓库的校验契约与目录结构;名称格式受限;不会覆盖已有内容;其余功能细节暂未提供。