元数据格式规范

本文档详细定义了 skill.yaml 文件中所有可用字段及其类型。

必需字段

字段	类型	描述
ass_version	string	规范版本，如 "1.0"
name	string	技能唯一标识符
version	string	语义化版本号
description	string	简短描述 (最多 160 字符)

可选字段

字段	类型	默认值	描述
author	object	-	作者信息
license	string	"MIT"	开源许可证
keywords	string[]	[]	搜索关键词
categories	string[]	[]	分类标签
compatibility	object	-	平台兼容性
triggers	string[]	[]	触发条件
security	object	-	安全配置

字段详解

author 对象

author:
  name: "HowToSkill Foundation"
  email: "[email protected]"  # 可选
  url: "https://howtoskill.org"    # 可选

compatibility 对象

compatibility:
  platforms:
    - claude-code
    - claude-api
    - openai-gpt
    - custom-agent
  min_runtime: "1.0"
  max_runtime: "2.0"  # 可选

security 对象

security:
  network_access: false          # 是否需要网络
  allowed_hosts:                  # 白名单域名
    - "api.example.com"
  filesystem_scope: "workspace"  # workspace | project | system
  requires_approval: false       # 是否需要用户确认