SuperAPI AI 工具集

creating-skills

智能体与模型

查看项目

更新于 10-15 23:59

技能介绍

用途:为 Letta Code 用户提供创建有效技能(或更新既有技能)的指导,使智能体从通用型转为具备特定领域流程与知识的专用型。官方完整规范见 agentskills.io。

主要能力:说明技能可提供专门工作流、工具集成、领域专长与打包资源(脚本、参考文档、素材)。核心原则包括:保持简洁,只补充智能体尚不具备的上下文;按任务脆弱性设置自由度(高自由度文本指令、中自由度带参脚本、低自由度固定脚本)。

结构与用法:每个技能须有 SKILL.md,其 YAML frontmatter 含 name(须与目录名一致,动名词、小写字母数字连字符、最多 64 字符)和 description(第三人称,说明用途与触发时机,最多 1024 字符);正文为 Markdown,仅在触发后加载。可选捆绑资源:scripts/(可执行代码,无需载入上下文,但可能需读取以修补)、references/(按需载入的文档,大文件建议在 SKILL.md 中给出 grep 模式,避免与正文重复)、assets/(用于最终输出的模板、图片、字体等,不载入上下文)。采用三级渐进式披露:元数据常驻、SKILL.md 触发时加载(正文建议不超过 500 行)、资源按需加载。拆分内容时应从 SKILL.md 直接引用,引用保持一层深度,长文件加目录。

创建流程:先以具体示例理解技能用途;再规划可复用内容;然后运行初始化脚本:npx tsx <SKILL_DIR>/scripts/init-skill.ts <skill-name> --path <output-directory>,生成模板与示例目录;接着编辑资源并更新 SKILL.md(新增脚本须实际运行测试);再用 package-skill.ts 打包;最后基于真实使用迭代。

限制:技能中不应包含 README、安装指南、快速参考、变更日志等多余文档,只保留支撑功能的必要文件;不要编造未在资料中给出的价格、平台或效果。