SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-16 00:21

技能介绍

用途:这是一个指导如何创建有效技能(Skill)的元技能,适合用户想要新建或更新一个扩展 Claude 能力的技能时使用。技能被视为模块化、自包含的包,为 Claude 提供特定领域的专门知识、工作流和工具。

主要能力与核心原则:强调精简,因为上下文窗口是公共资源;每个信息都要衡量其 token 成本;优先用简洁示例而非冗长解释。技能应设定合适的自由度:高自由(文本指令)用于多路径可行场景,中自由(伪代码或带参数的脚本)用于有偏好模式但允许变化,低自由(具体脚本、少量参数)用于操作脆弱、需一致性或固定顺序的场景。

技能结构:每个技能包含必需的 SKILL.md 和可选资源目录。SKILL.md 由 YAML frontmatter(必需 name 和 description,可选 compatibility 等)和 Markdown 正文组成;只有 name 和 description 被读取以决定触发,正文在触发后才加载。可选资源包括 scripts/(可执行代码)、references/(按需加载的文档)和 assets/(用于最终输出的模板、图标、字体等)。不应包含 README、安装指南、快速参考、变更日志等多余文件。

渐进式披露:采用三级加载——元数据始终在上下文、SKILL.md 正文在触发时加载(建议 500 行以内、<5k 词)、捆绑资源按需加载。拆分内容时需从 SKILL.md 引用并说明何时读取;引用保持一层深度;长文件加目录。

创建流程:1)用具体示例理解技能用法;2)规划可复用内容(脚本、参考、资产);3)运行初始化脚本 skills/skill-creator/scripts/init_skill.py --name <skill-name> --path <output-directory>;4)编辑技能,先实现可复用资源并实测脚本,再更新 SKILL.md(正文用祈使句,触发信息全部写在 description);5)用 package_skill.py 打包;6)根据实际使用迭代。生成技能须保存在当前项目 .claude/skills/ 下,项目根路径由 MAX_PROJECT_PATH 环境变量提供。限制:资料未提供具体收费、平台或效果信息。