SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-16 05:50

技能介绍

skill-creator 来自 hashintel/hash,是一份用于创建有效 Agent Skills 的指南,适合需要为 AI 代理新增或更新技能、以扩展其能力的场景。

用途:指导按 Agent Skills 规范编写技能。技能被描述为模块化、自包含的包,通过专业工作流、工具集成、领域知识和打包资源,将通用代理变为专用代理。

核心原则:强调简洁,上下文窗口是公共资源,只补充代理不掌握的信息;并按任务脆弱性设定自由度——高自由度用文字指令,中自由度用伪代码或带参数脚本,低自由度用具体脚本和少量参数。

技能结构:每个技能包含必需的 SKILL.md 和可选资源。SKILL.md 需要 YAML frontmatter,name 必填、最长 64 字符、仅小写字母数字连字符且与目录名一致;description 必填、最长 1024 字符,说明做什么与何时使用;可选 license、compatibility、metadata、allowed-tools。还可通过 metadata.triggers 配置关键字、意图正则、文件路径与内容匹配,并设置 suggest、warn、block 等级。

资源目录:scripts/ 放可执行代码,references/ 放按需加载的文档,assets/ 放输出用模板、图标、字体等。采用三级渐进式披露:元数据常驻上下文,SKILL.md 在触发时加载,资源按需加载;正文建议不超过 500 行。

使用流程:先用具体例子理解技能用途,再规划可复用内容;运行 yarn agents:skill-management init <skill-name> 初始化到 .claude/skills/;编辑 frontmatter 与正文;执行 yarn agents:skill-management validate 和 generate-skill-rules 生成校验规则;最后用指定命令测试匹配逻辑。

适用场景:为代理添加特定领域流程、公司知识、API 或文件格式处理、以及重复任务脚本模板。限制:资料未提供收费、价格、平台、效果等信息;部分字段标注为实验性,具体运行环境要求暂未提供。