John Qiu
99881e268a
- 重命名 plugins/ → skills/，个人插件迁移到 skills-personal/（gitignore） - 更新 generate-marketplace.py 支持 config 读取和 skills-personal 扫描 - 新增 claude-config.yaml（技能启用/禁用 + MCP 配置） - 新增 init.sh（交互式 MCP 初始化，支持 stdio/SSE 模式） - 新增 CLAUDE.md 项目说明 - 重写 README.md 反映新结构 - 删除过时脚本：PUSH.sh、generate-marketplace.sh、convert-skills.sh Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
skill.yaml 规范文档
概述
skill.yaml 是技能的元数据定义文件，位于技能仓库根目录。
字段定义
必填字段
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
name |
string | hyphen-case, ≤64字符 | 技能唯一标识 |
version |
string | 语义化版本 | 当前版本号 |
description |
string | ≤1024字符 | 技能描述 |
可选字段
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
author |
string | - | 作者/团队 |
license |
string | - | 许可证 |
triggers |
object | - | 触发条件 |
prompt_file |
string | SKILL.md | 提示词文件 |
dependencies |
array | [] | 依赖技能列表 |
mcp_servers |
array | [] | MCP 服务器依赖 |
hooks |
object | - | 生命周期钩子 |
allowed_tools |
array | - | 允许的工具 |
metadata |
object | - | 自定义元数据 |
triggers 结构
triggers:
# 关键词触发 - 用户输入包含这些词时激活
keywords:
- coolbuy-paas
- 酷采
# 命令触发 - 用户输入以这些命令开头时激活
commands:
- /skill
# 文件模式触发 - 当前目录匹配时激活
file_patterns:
- "**/coolbuy-paas/**"
hooks 结构
hooks:
# 安装后执行
post_install:
- "echo 'Installed'"
- "npm install"
# 更新后执行
post_update:
- "echo 'Updated'"
# 卸载前执行
post_uninstall:
- "echo 'Goodbye'"
完整示例
name: coolbuy-paas
version: 1.2.0
description: |
酷采3.0 SaaS 租户端开发与测试。
支持商品管理、订单管理等模块开发。
author: your-team
license: MIT
triggers:
keywords:
- coolbuy-paas
- 酷采
- 商品管理
- 租户端
file_patterns:
- "**/coolbuy-paas/**"
prompt_file: SKILL.md
dependencies:
- dev-coding
- ops-tools
mcp_servers:
- ai-proj
- chrome-devtools
hooks:
post_install:
- "echo '✓ coolbuy-paas 技能安装完成'"
post_update:
- "echo '✓ coolbuy-paas 技能已更新'"
allowed_tools:
- Bash
- Read
- Write
- Edit
- Glob
- Grep
metadata:
category: business
tags:
- saas
- ecommerce
- tenant
min_claude_version: "1.0.0"
project_repo: "https://github.com/org/coolbuy-paas"
验证规则
-
name:
- 只能包含小写字母、数字、连字符
- 不能以连字符开头或结尾
- 长度 1-64 字符
-
version:
- 符合语义化版本规范 (SemVer)
- 格式: MAJOR.MINOR.PATCH
-
description:
- 长度不超过 1024 字符
- 不能包含
<或>字符
-
prompt_file:
- 文件必须存在
- 必须是 Markdown 格式
-
dependencies:
- 每个依赖必须是有效的技能名称
- 不能有循环依赖
与 Anthropic 官方规范对比
| 字段 | 官方规范 | 本规范 | 说明 |
|---|---|---|---|
| name | ✓ | ✓ | 相同 |
| description | ✓ | ✓ | 相同 |
| license | ✓ | ✓ | 相同 |
| allowed-tools | ✓ | allowed_tools | 命名调整 |
| metadata | ✓ | ✓ | 相同 |
| version | ✗ | ✓ | 新增 |
| triggers | ✗ | ✓ | 新增 |
| dependencies | ✗ | ✓ | 新增 |
| hooks | ✗ | ✓ | 新增 |
| mcp_servers | ✗ | ✓ | 新增 |