SuperAPI AI 工具集

skill-best-practices

智能体与模型

查看项目

更新于 10-16 03:17

技能介绍

用途:该技能提供一套编写智能体技能(agent skill)的规范流程,帮助作者按 agentskills.io 规范与渐进式披露原则生成技能目录与文件。

主要能力与步骤:

  1. 初始化并校验元数据:名称需为 1-64 字符,仅小写字母、数字和单个连字符;描述最多 1,024 字符,用第三人称书写并包含否定触发条件。运行校验脚本:python3 scripts/validate-metadata.py --name "[name]" --description "[description]",若报错则依据 stderr 自行修正并重跑。
  2. 组织目录:以校验后的名称创建根目录,并初始化 scripts/(小型 CLI 工具与确定性逻辑)、references/(一层深的上下文,如 schema 或 API 文档)、assets/(输出模板、JSON schema 或静态文件)。不创建 README.md、INSTALLATION.md 等面向人的文件。
  3. 撰写核心逻辑 SKILL.md:以 assets/skill-template.md 为起点,全部指令使用第三人称祈使句;主逻辑控制在 500 行以内,大型 schema 或复杂规则移入 references/,并指示智能体仅在需要时读取指定文件。
  4. 识别并打包脚本:针对正则、复杂解析或重复样板等脆弱任务,为 scripts/ 编写单一用途脚本,并通过 stdout/stderr 向智能体反馈成功或失败。
  5. 最终校验:检查 SKILL.md 是否存在“幻觉缺口”(迫使智能体猜测之处),确认所有文件路径为相对路径并使用正斜杠,最后对照 references/checklist.md 复核。

错误处理:元数据校验失败时定位具体错误(如 STYLE ERROR)并改写字段以去除第一/第二人称;上下文膨胀超过 500 行时,将最大的流程块移入 references/ 文件。

限制:资料未提供该技能的收费、价格、平台或效果信息;具体脚本实现与模板内容暂未提供。