SuperAPI AI 工具集

skill-structure

编程与开发

查看项目

更新于 10-16 00:03

技能介绍

Skill Structure 用于在创建技能文件或斜杠命令时参考的结构规范。

用途:自定义斜杠命令与技能实为同一事物,.claude/commands/review.md 与 .claude/skills/review/SKILL.md 都生成 /review;同名时技能优先。简单单文件工作流用命令文件,需要引用文件、背景知识或渐进式披露时用技能目录。

命名规则:kebab-case 小写,1-64 字符,匹配 ^[a-z][a-z0-9](-[a-z0-9]+)$,必须与目录名完全一致,不允许大写、下划线、开头连字符或连续连字符。name 字段只写最终技能名而非完整路径,可用嵌套目录分组。

目录结构:常用扁平 skills/name/SKILL.md;复杂技能可拆分为 SKILL.md(小于 500 行)、references/、scripts/、assets/ 子目录,引用只允许一层深度,脚本执行不加载进上下文。

frontmatter:name 可选(默认目录名),description 建议填写且不超过 1024 字符,可含 argument-hint、disable-model-invocation、user-invocable、allowed-tools、model、context、agent。描述模板为“做什么。何时使用。触发关键词”。

调用控制:默认用户与 Claude 均可调用;user-invocable: false 表示隐藏于 / 菜单,适合背景知识。建议避免 disable-model-invocation: true,有副作用的技能应使用确认步骤。

动态特性:用 $ARGUMENTS 接收参数,支持 $0、$1 等;用 !command 在内容送入模型前执行 shell 命令并替换为输出;context: fork 配合 agent 可在隔离子代理上下文运行。

限制:SKILL.md 最多 500 行,name 最多 64 字符,description 最多 1024 字符;使用标准 markdown 标题而非 XML 标签。以上为资料明确内容,其他细节暂未提供。