SuperAPI AI 工具集

creating-skills

智能体与模型

查看项目

更新于 10-16 06:48

技能介绍

用途:该技能为创建有效的 Agent Skills 提供指导,适用于用户想新建技能、更新已有技能或需要规范技能结构时。技能被定义为模块化、自包含的包,通过专门知识、工作流和工具扩展 Claude 的能力。

主要能力:说明技能可提供专门工作流、工具集成、领域专长和捆绑资源;强调精简优先,只补充 Claude 尚不具备的上下文;按任务脆弱性设置自由度(高自由度文本指令、中自由度伪代码或带参脚本、低自由度固定脚本)。

结构:每个技能包含必需的 SKILL.md(YAML frontmatter 的 name 与 description,以及 Markdown 正文)和可选捆绑资源:scripts/ 可执行代码、references/ 按需加载文档、assets/ 输出用文件。不应包含 README、安装指南、速查表、变更日志等多余文件。采用三级加载:元数据常驻、SKILL.md 触发时加载、捆绑资源按需加载,正文建议不超过 500 行。

创建流程:用具体示例理解技能;规划可复用内容;运行 python3 scripts/init_skill.py <skill-name> --path <output-directory> 初始化;编辑 SKILL.md 与资源;运行 python3 scripts/package_skill.py <path/to/skill-folder> 打包;根据实际使用迭代。description 只写触发条件,以“Use when...”开头,不总结工作流,最多 1024 字符。

验证:运行 python3 scripts/verify.py,预期输出 ✓ creating-skills valid;验证其他技能用 python3 scripts/verify.py /path/to/skill-folder;失败时加 --verbose 诊断,检查 YAML frontmatter、名称格式与 description 触发条件。

限制:资料未提供具体收费、价格、平台支持范围或效果保证;部分命令与脚本依赖本地 Python 环境,实际可用性暂未提供。