SuperAPI AI 工具集

kf-skill-naming-creation-organization-rules

通用与其它

查看项目

更新于 10-15 23:56

技能介绍

用途:在仓库中新增、改名或整理 skill 时,统一应用命名规约与放置方针,覆盖目录名选择、是否加前缀、分类层级与 frontmatter 英文书写。

主要规则:外部 skill(记录于 skills-lock.json)视为外部来源,原则上不改目录名与内容;自作 skill 放入 .agents/skills/ 下。melumuccu/ai 中自作 skill 目录名以 kf- 开头,kf- 后紧跟大分类;其他仓库不加前缀,直接以大分类起始。分隔符统一用连字符,不用下划线,仅用小写英文字母、数字与连字符,不使用非 ASCII 字符、日文或空格。大分类为表达主题领域的名词(如 markdown、skill、git、python、shell、research),下级分类按需添加,避免不必要细分。名称末尾放简短英文概要,尽量为名词短语或短功能名。frontmatter 统一英文:name 与目录名一致的 ASCII kebab-case,description 为说明用途与触发条件的一至两句英文。

命名步骤:确认目标仓库;确定主题领域;优先复用已有大分类;不足时补充新的短英文名词;必要时加一至两个下级分类;末尾加简短英文概要;按 melumuccu/ai 用 kf-large-category-...-short-summary、其他仓库用 large-category-...-short-summary 整理;frontmatter 的 name 与目录名一致并用英文 description;检查是否过长且列表中可辨。

整理与改名:外部 skill 不纳入整理对象;仅自作 skill 按规约调整并统一前缀;新增、改名或删除后需重新生成 .agents/skills/skills.json。

输出与检查:用户只要名称时提供多个候选;需要创建时给出合规目录名与 SKILL.md,并先确认目标仓库决定是否加前缀;frontmatter 用英语;可简述大分类选择理由;避免过度细分。返回前检查前缀、大分类位置、连字符、name 与目录名一致、分类自然、下级分类不过多、末尾概要简短、description 为英文,以及外部与自作 skill 不混淆。