用途
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 仓库内批量创建技能、对已有技能做统一校验与索引生成、以及在提交前自动发现新增技能并完成收尾与暂存。
限制
资料未提供该技能的收费、平台支持范围与效果数据,暂未提供。