用途:为 SwarmClaw 智能体创建、编辑、改进或审计技能。技能是模块化、自包含的包,为通用智能体提供专门知识、工作流与工具,使其转变为专用智能体。
主要能力:提供专门工作流(特定领域的多步流程)、工具集成(特定文件格式或 API 的使用说明)、领域专长(公司特定知识、模式、业务逻辑)以及捆绑资源(脚本、参考文档、资产)。
技能结构:技能目录包含必需的 SKILL.md(YAML frontmatter 含 name 与 description,加 Markdown 指令),以及可选的 scripts/(可执行代码)、references/(按需加载的文档)、assets/(输出用模板、图标、字体)。
创建流程:先用具体示例理解技能需求,规划可复用内容,初始化技能,编辑技能,校验,再根据实际使用迭代。初始化命令:python3 {baseDir}/scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]。校验命令:python3 {baseDir}/scripts/quick_validate.py <path/to/skill-folder>。
命名规则:仅小写字母、数字和连字符,少于 64 字符,优先使用动词开头的短语,文件夹名与技能名一致。
编写原则:保持精简,只添加智能体尚不具备的上下文;SKILL.md 正文控制在 500 行以内,使用祈使/不定式;description 需同时说明技能做什么和何时使用,这是技能选择的主要触发机制。采用三级渐进式加载:元数据始终在上下文中,SKILL.md 正文在触发时加载,捆绑资源按需加载。
限制:不应包含 README、CHANGELOG、安装指南等辅助文档,也不应包含智能体已从通用训练中掌握的信息。资料未提供具体收费、平台支持范围等信息。