用途:在当前仓库中从零创建一个新技能,按 .agents/skills/README.md 定义的工作流执行。适用于用户想要创建或添加新技能、或提到从零创建技能的场景。
主要流程:
- 收集意图:先向用户确认技能名称(仅小写字母、数字与连字符,如 gh-create-pr、prepare-release)、描述(含具体触发场景,如“当用户要求创建 PR 时使用”)、是否为公开技能(默认否,仅私有)、可选的测试用例;若用户只提供部分信息,可按合理默认值继续并请用户确认。
- 阅读指南:创建前始终先读 .agents/skills/README.md,确保符合当前工作流。
- 创建结构:生成目录 .agents/skills/<skill-name>/ 及其中 SKILL.md。SKILL.md 含 frontmatter 字段 name 与 description,正文为技能指令。name 为小写字母、数字、连字符;description 说明何时触发。
- 同步(仅公开技能):把技能名写入 .agents/skills/public-skills.txt(每行一个,不要行内注释),然后运行 pnpm skills:sync,在 .claude/skills/<skill-name>/ 生成指向 .agents/skills/<skill-name>/ 的符号链接。注意 pnpm skills:check 主要校验公开技能及相关治理文件,因此必须先同步再校验。
- 校验:运行 pnpm skills:check,有问题修复后重跑。
- 总结:向用户说明创建的文件、校验结果与后续使用方式。
命名规则:仅小写字母、数字和连字符;优先简短、面向动作的名称。公开与私有的区别:私有技能只放在 .agents/skills/,无需同步;公开技能需同时添加到 public-skills.txt 并运行 pnpm skills:sync。
命令:pnpm skills:check(校验技能结构)、pnpm skills:sync(同步公开技能到 Claude)。
限制:不得在 .agents/skills/<skill-name>/ 之外创建技能;完成前必须运行 pnpm skills:check;公开技能必须同时登记并同步。若存在 skill-creator 技能,可用于进阶开发(评估、迭代),但本技能负责基础创建流程。