SuperAPI AI 工具集

repo-skill-creator

编程与开发

查看项目

更新于 10-30 16:21

技能介绍

用途

repo-skill-creator 用于在 adonis-skills 仓库中创建和维护仓库技能(repository skills)。它把“新建技能—校验—生成索引—暂存相关文件”的流程固化为可执行的三套模式,便于统一管理 skills/ 目录下的技能。

触发规则

  • 若用户提供的路径位于 skills/* 之下,并表示技能已生成或复制完成,则直接执行路径收尾模式,无需额外确认。
  • 若用户直接调用本技能但未提供路径,则先执行自动发现收尾模式(skills:finalize:new)。
  • 自动发现模式未发现新技能时,回退到创建模式(skills:new),随后继续收尾。

模式 A:创建新技能

推荐命令:

pnpm skills:new

手动创建方式:

pnpm skills:init <skill-name> --path skills --resources scripts,references
pnpm skills:finalize -- skills/<skill-name>

模式 B:按路径收尾已有技能

当用户给出 skills/* 下的路径时运行:

pnpm skills:finalize -- <skill-path>

示例:

pnpm skills:finalize -- skills/code-inspector-init
pnpm skills:finalize -- /Users/adonis/coding/adonis-skills2/skills/code-inspector-init/

收尾流水线固定且须按顺序执行:

pnpm skills:quick-validate skills/<skill-slug>
pnpm skills:validate
pnpm skills:index

模式 C:自动发现、收尾并暂存

未传入 skills/* 路径时运行:

pnpm skills:finalize:new

行为约定:

  • 从 git status --short --untracked-files=all 发现新增技能候选,纳入 A(已加入索引)与 ??(未跟踪)两类;仅接受 skills/<slug>/SKILL.md 本身处于 A 或 ?? 状态的 slug。
  • 按稳定排序对每个发现的 slug 执行 pnpm skills:finalize -- skills/<slug>,首次失败即停止。
  • 全部收尾成功后仅暂存相关文件:对每个处理的 slug 执行 git add skills/<slug>,若 apps/web/src/generated/skills-index.json 有变更则一并 git add。
  • 若未发现新技能,自动运行 pnpm skills:new,重新扫描后继续本模式。

边界约束

  • 除非明确要求,不自动运行 pnpm skills:openai-yaml。
  • 除非明确要求,不自动运行本地安装/同步(skills:install:local、skills:test:local)。
  • 不使用 git add -A,只暂存本流程涉及的技能相关文件。

输出约定

执行本技能时始终返回:已执行(或 dry-run 中计划执行)的命令、成功/失败状态、检测与处理的技能 slug 及已暂存文件路径;仅在有用时给出下一步建议(例如通过 pnpm skills:test:local 进行本地智能体测试)。

技能规范

  • 技能名称使用小写连字符格式。
  • SKILL.md frontmatter 保持有效,name 与 description 非空。
  • frontmatter.description 必须仅使用英文(ASCII 字符),并清楚说明何时使用该技能。
  • 仅在需要时添加可选目录(scripts/、references/、assets/)。
  • 更新后、提交前重新运行校验与索引生成。

适用场景

适合在 adonis-skills 仓库内批量创建技能、对已有技能做统一校验与索引生成、以及在提交前自动发现新增技能并完成收尾与暂存。

限制

资料未提供该技能的收费、平台支持范围与效果数据,暂未提供。