用途:在 foundation-skills 仓库中创建一个符合全部仓库约定的新技能(skill)。
主要能力:引导收集需求(技能覆盖的任务或领域、需处理的用例、触发关键词/短语/文件类型、需包含的参考资料);选择技能名(小写 kebab-case,简短描述性,并确认 skills/ 下未被占用);生成 skills/<name>/SKILL.md 与 docs/<name>.md。
使用方式:SKILL.md 从 skills/_TEMPLATE/SKILL.md 起步,frontmatter 为 YAML,name、description、version 必须位于根级(不嵌套在 metadata 下),description 不超过 1024 字符,首句说明功能,第二句写“Use when [triggers].”,新技能 version 从 1.0.0 开始,正文用英文且控制在 100 行以内,采用渐进式披露,把详细内容放入 reference/ 文件,并包含具体示例。若技能依赖外部 CLI 工具(如 gh、glab、jq、playwright),需添加 ## Prerequisites 段并列出各工具及安装命令;若该工具未被 skills/setup/reference/setup.sh 处理,则加入其中并提升 setup 版本。内容超过 100 行或涉及不同领域时,拆分为 reference/detailed-guide.md、reference/examples.md 等,引用层级仅一层。docs/<name>.md 用法语编写,包含标题、Description、Cas d'usage、Declenchement、Fonctionnement、Exemples(英法双语)和版本号。
适用场景:为 foundation-skills 仓库新增或维护技能时使用。
限制:SKILL.md 必须为英文,文档必须为法语;不鼓励使用脚本,优先 Markdown 指令,仅确定性操作才加脚本;避免时效性信息;修改已有技能时按 patch/minor/major 规则提升版本。