SuperAPI AI 工具集

skill-creator

通用与其它

查看项目

更新于 10-16 09:33

技能介绍

用途:指导创建、更新、打包技能包(Skill)。技能是模块化的自包含包,通过专门知识、工作流与工具扩展 Claude 能力,可类比特定领域的上手引导,把通用智能体转为具备过程性知识的专用智能体。技能可提供专用工作流、工具集成、领域专业知识(公司特定知识、schema、业务逻辑)以及脚本、参考文档、资源等捆绑资源。

核心原则:上下文窗口是公共资源,默认 Claude 已足够聪明,只补充其不具备的上下文;优先精炼示例而非冗长解释。按任务脆弱性与可变性设定自由度:高自由度用文本指令,中自由度用带参数的伪代码或脚本,低自由度用具体脚本与少量参数。

结构:每个技能包含必需的 SKILL.md 与可选捆绑资源。SKILL.md 含 YAML frontmatter(name、description 必需,compatibility 可选)与 Markdown 正文;正文仅在触发后加载。资源分 scripts/(可执行代码,如 scripts/rotate_pdf.py)、references/(按需载入的文档,如 schema、API 文档、政策)、assets/(用于输出、不载入上下文的模板、图标、字体等)。不要创建 README、安装指南、快速参考、变更日志等多余文档。

渐进披露:元数据常驻上下文(约 100 词);SKILL.md 正文在触发时加载(建议 500 行内、少于 5k 词);捆绑资源按需加载。多领域或多框架时按领域/变体拆分参考文件,并由 SKILL.md 直接链接,避免深层嵌套;超过 100 行的参考文件加目录。

创建流程:先依据任务历史理解用户意图并向用户复述确认;随后在 ./output/skill-creation.todo.md 建立并维护 TODO 跟踪([ ] 未开始、[-] 进行中、[x] 完成、[!] 阻塞);用具体示例理解技能用途;规划可复用内容;运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化模板;编辑实现;运行 package_skill.py 打包;再按真实使用迭代。资料未提供更详细的编辑、打包与发布参数说明。