SuperAPI AI 工具集

notis-skill-creator

智能体与模型

查看项目

更新于 10-16 01:17

技能介绍

用途:指导创建或迭代 Notis 技能。技能是自包含的指令、参考与可选脚本单元,用于扩展助手能力。适用场景包括用户要求创建新技能、迭代或打包现有技能,以及询问技能结构、校验或分发方式。

主要能力与工作流:

  1. 定义技能:确定 kebab-case 名称、一两句描述(说明做什么、何时使用)以及范围(仅指令,或指令加脚本/参考/资源)。
  2. 规划内容:SKILL.md 必需,含 YAML frontmatter(name、description)与主指令;scripts/ 放可执行代码;references/ 放按需加载文档;assets/ 放模板、图片等输出文件。
  3. 初始化:手动创建目录,例如 mkdir -p my-skill/scripts my-skill/references my-skill/assets,再创建 my-skill/SKILL.md 并写入 frontmatter。
  4. 编写与迭代:指令清晰可执行,包含使用时机、必需输入与预期输出;按路径引用脚本或资源;在真实场景中测试。
  5. 保存或更新:先发现原生技能工具并读取已安装列表,按精确 id、owner 与 Space 链接解析现有技能,不要取第一个同名匹配。单文件创建用 LOCAL_NOTIS_CREATE_SKILL,单文件编辑用 LOCAL_NOTIS_UPDATE_SKILL;多文件用 CLI --file bundle_url=./skill.zip 上传。更新不得增加已安装记录数,并需回读校验。

状态与模型:技能若需跨运行保留历史、进度、审批、队列、缓存或结果,应使用 Notis 数据库行或文档,而非本地文件;脚本只写临时目录,不写入技能自身文件夹。生成、分类、研究等模型工作由运行技能的智能体或其子智能体承担,仅在用户明确要求时才提供调用模型提供商 API 的脚本。

智能与调用覆盖:为每个委派步骤声明 low、medium 或 high,未指定时用 high;不要嵌入厂商模型名、版本固定、价格表或单独的努力映射。使用 LOCAL_NOTIS_GET_INTELLIGENCE_POLICY 获取共享契约与当前映射。用户显式选择覆盖技能默认值,不要更改已保存的账户默认值。

限制与注意:精选技能在规范源维护并单独发布,普通用户技能更新不能替换精选内容;Space 中链接的技能为共享资源,编辑会影响所有链接它的 Space。需校验 frontmatter、资源路径与预期变更,并先试运行。文件变更时 CREATE 和 UPDATE 会返回 review_url 供逐行评论。产品源位于 server/skills/,开发工作流位于 .agents/skills/,不要编辑生成的镜像或厂商缓存作为规范源。