用途:在 foundation-skills 仓库中创建符合仓库约定的新技能(skill),生成 SKILL.md 骨架与配套文档。
主要能力与工作流: 一、收集需求:向用户确认技能覆盖的任务或领域、需处理的具体用例、触发条件(关键词、短语、文件类型)、需包含的参考资料。 二、命名:使用小写 kebab-case(如 my-new-skill),简短且具描述性,并确认 skills/ 下未被占用。 三、创建 skills/<name>/SKILL.md:以 skills/_TEMPLATE/SKILL.md 为起点,强制约定包括:YAML frontmatter 需在根级提供必填的 name、description、version(不嵌套在 metadata 下);description 上限 1024 字符,首句说明功能,第二句为 "Use when [triggers].";新技能版本从 1.0.0 起;SKILL.md 用英语书写。正文规则:控制在 100 行以内,仅写简洁可执行的说明;采用渐进式披露,将详细内容放入 reference/ 文件;包含具体示例;不写时效性信息。若依赖外部 CLI 工具(如 gh、glab、jq、playwright),需添加 ## Prerequisites 段落列出各工具及安装命令;若该工具尚未由 skills/setup/reference/setup.sh 处理,则加入其中并提升 setup 版本(该脚本手动维护)。 四、参考文件:内容超过 100 行或领域分散时,拆分为 SKILL.md 与 reference/ 下的 detailed-guide.md、examples.md,并在 SKILL.md 中引用(如 See detailed guide)。 五、创建 docs/<name>.md:用法语撰写,须含标题、Description、Cas d'usage、Declenchement、Fonctionnement、Exemples(英法双语示例)与版本号。 六、检查清单:确认 SKILL.md 存在且 frontmatter 有效、description 含触发条件且不超 1024 字符、正文不超 100 行且为英语、docs/<name>.md 存在且为法语、无时效信息、术语一致、含具体示例、参考文件仅一层深、需要时含 Prerequisites 与安装命令、必要时更新 setup.sh 并提升其版本。
版本规则:修改已有技能时提升 version——patch(1.0.0→1.0.1)用于拼写、措辞与小幅澄清;minor(1.0.0→1.1.0)用于新功能、新段落或行为变化;major(1.0.0→2.0.0)用于破坏性变更(改名、删除功能、重构流程)。
要点与限制:每个技能位于 skills/<name>/SKILL.md,文档位于 docs/<name>.md(法语);description 是 Agent 选择加载哪个技能时唯一可见内容,需重点打磨;不鼓励脚本,优先用 Markdown 指令,仅确定性操作才添加脚本。资料未提供具体安装命令示例与现有 docs/ 文件内容。