SuperAPI AI 工具集

agent-file-specs

智能体与模型

查看项目

更新于 10-15 22:41

技能介绍

用途:为 AI 编程助手的定制文件提供统一、最新的规范参考,帮助开发者编写 agents、skills、prompts、instructions 等文件,并了解不同提供商的存放位置与 VS Code 配置。规格与 Agent Skills 开放标准及 VS Code Copilot 定制文档保持一致。

主要能力:按文件类型提供专门参考文档,包含完整属性表、校验规则、示例和最佳实践;提供文件位置参考(各提供商基础目录、目录结构、命名约定);提供 VS Code 中控制定制文件发现与行为的设置参考。

文件类型与用途:Agent(.agent.md / .md)用于带专用行为、工具限制和交接流程的自定义 AI 角色;Skill(目录内 SKILL.md,遵循 Agent Skills 开放标准)用于可复用、可移植的能力,含脚本与资源;Prompt(.prompt.md)用于以斜杠命令调用的可复用提示模板;Instruction(.instructions.md)用于按文件类型或描述自动应用的上下文指导;另有 File Locations 与 VS Code Settings 参考。

使用方式:先阅读快速参考确定所需文件类型,再进入对应参考文档获取完整细节;需要了解文件放置位置时查 File Locations,需要 VS Code 配置时查 Settings。详细规格存放在 references/ 文件夹而非主技能文件,以保持主文件轻量、按渐进式披露模型高效加载上下文。

提供商支持:GitHub Copilot 使用 .github/,Claude Code 使用 .claude/,Codex 使用 .codex/,OpenCode 使用 .config/opencode/;各提供商基础文件夹不同,但文件格式一致。

选择指引:全局编码规范用常开 instructions(如 .github/copilot-instructions.md 或 AGENTS.md);按文件类型区分规则用带 applyTo 模式的 .instructions.md;重复执行的可复用任务用 .prompt.md 斜杠命令;多步骤、含脚本与资源的工作流用 Skill 目录;需要工具限制的专用 AI 角色用 .agent.md,并支持交接流程。

限制:除上述内容外,具体收费、价格、平台限制与效果暂未提供;详细规范需查阅 references/ 文件夹,官方文本未提供。