SuperAPI AI 工具集

creating-skills

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:该技能用于指导在本仓库中创建有效的 GitHub Copilot Agent Skills,适用于发现新工具、收到与任务无关的评审建议,或研究出专门工作流之后。

主要能力与流程:创建前先做重复检查,列出并阅读现有技能:ls -la .github/skills/;若已有语义相近的技能,应停止新建,改为更新其 description、补充关键词或增加章节,仅在无语义重叠、问题域不同且触发条件独特时才新建。

结构要求:技能放在 .github/skills/ 目录下,每个技能一个子目录,目录名小写并用连字符,且与 frontmatter 的 name 一致;目录内必须有大小写敏感的 SKILL.md,包含 YAML frontmatter 和 Markdown 正文,还可附带脚本、示例、模板和参考文档。

Frontmatter:name 为唯一标识,小写连字符并与目录名一致;description 用 1-2 句说明何时与为何使用,包含触发关键词,便于 AI 识别加载。可选 license。描述应具体、可操作、含关键词,避免“帮助调试”这类笼统表述。

正文与效率:建议按标题与概述、何时使用、前置条件、分步说明、示例、故障排查、参考链接组织;使用祈使语气,给出命令示例与预期输出,用带语言标识的代码块,突出警告信息。保持简洁以节省上下文 token,引用外部资源而非重复内容。

测试与迭代:创建后检查文件结构、校验 YAML 语法与必填字段、确认名称与目录一致,再用应触发该技能的问题测试 Copilot 是否加载,并根据使用情况优化描述与说明。仓库中可参考 hypothesis-driven-debugging 等现有技能。

限制:资料未提供具体收费、平台支持范围或效果数据;示例与命令需按实际仓库情况调整。