用途:在指定仓库中新增、改名或整理 skill 时,统一应用命名与放置规范,避免命名混乱,使同类 skill 在列表(按字母排序)中相邻排列。
适用场景:新建 skill、决定目录名、检查已有 skill 名是否符合规范、按类别整理 skill、区分外部 skill 与自制 skill、决定英文 frontmatter 写法。
仓库前提:skills-lock.json 中的 skill 视为外部来源,原则上不直接修改其目录名或内容,需要调整时优先用自制 skill 补足;自制 skill 放在 .agents/skills/ 下。
命名规范:目录名以表示主题领域的大类别开头,必要时接 1 至 2 个下位类别,末尾放简短英文概要(如 large-category-subcategory-short-summary)。大类别为名词(如 markdown、skill、git、python、shell、research),不用动词或临时用途名;不固定大中小三级,避免为分类而增加多余类别。优先复用已有大类别,没有合适者才新增。示例:kf-g-git-commit-japanese-commit-message、kf-g-research-paper-paper-summary、kf-g-shell-log-log-analysis。应避免 review-changes-clearly-for-humans 这类冗长句。
命名步骤:确定主题领域→查已有大类别并复用→必要时新增短英文名词→按需加 1 至 2 个下位类别→末尾加简短英文概要→frontmatter 的 description 用英语写 1 至 2 句,说明用途与触发条件;正文和常规输出可用日语,但 frontmatter 不使用日语。
整理与改名:只整理自制 skill,外部 skill 不纳入规范;同类 skill 并排优先,保持大类别粒度一致;修改后如使用 .claude-plugin/marketplace.json,需同步更新 skill 的新增、改名、删除。
输出方针:用户只要名字时给出多个候选;需要创建时给出符合规范的目录名与 SKILL.md;可简述选择该大类别的理由,避免过度细分。
限制:资料未提供命名之外的功能实现、安装命令或收费信息。