SuperAPI AI 工具集

skills-creator

通用与其它

查看项目

更新于 10-15 19:53

技能介绍

用途:把工作流封装成小型、可移植的 NextCoWork Skill 包,用于扩展 NextCoWork 智能体,并便于在桌面端 Skills 视图中被发现。适用于从工作流简报或参考 Skill 创建新 Skill、在保留原有行为的前提下更新已安装 Skill、安装本地 ZIP 或市场 Skill、判断 Skill 应属于全局还是单个工作区、调试发现/前置元数据/激活/校验/诊断问题,以及准备发布到 Skills 市场。

主要能力:创建 Skill 包、安装、校验、更新与诊断。包的最小结构为 <skill-name>/SKILL.md,可按需添加 scripts/(可重复执行的确定性辅助脚本)、references/(按需加载的详细资料)、assets/(模板、图标、示例等输出资源)。目录名使用小写连字符,长度 1 到 64 字符,仅含 a-z、0-9 和 -,且目录名、frontmatter 的 name 与包根名必须完全一致。SKILL.md 以 YAML frontmatter 开头,包含 name 和 description,正文用祈使或不定式,说明目的、触发条件、工作流、输入、输出、约束与校验检查。

使用方式:全局 Skill 根目录为 <appData>/skills,由 getHost().paths.userData() 解析;开发环境为 <app working directory>/.next-cowork/skills,打包版本使用应用的用户数据目录。工作区本地根目录为 <workspace>/.next-cowork/skills。安装应复用现有渲染进程服务函数:pickSkillZip()、installSkillZip(path, workspaceId, scope)、installMarketSkill(slug, version, workspaceId, scope)、setSkillGlobalEnabled(skillId, enabled)、setSkillWorkspaceActive(skillId, workspaceId, active)。用户未指定工作区时默认全局范围。打包 ZIP 时保留顶层 <skill-name>/ 目录。

限制与注意:不得静默用不同包替换已有 Skill,应显示冲突并保留已安装副本直到用户选择更新。安装或发布前需校验 frontmatter 可解析且含 name 与 description、名称与目录一致、无路径穿越/绝对路径/重复条目/符号链接、脚本不依赖未声明的工作目录或密钥、所需引用与资源已从说明中链接、全局与工作区激活状态相互独立、畸形或超大 ZIP 产生本地化可读错误且不留下部分安装。发布前需本地安装成功,包含显示名、一句话描述、分类、版本、变更日志和所需资源,且不包含密钥、API 密钥、私有用户数据或机器相关绝对路径。图标建议使用正方形位图,1:1 裁剪,无文字水印,最终文件小于 256 KB。具体命令与代码示例资料中未提供。