SuperAPI AI 工具集

building-plugins

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:该技能在需要列出、构建、修改、删除或迁移 Amp 插件时使用。Amp 支持用 TypeScript 编写插件扩展。最新插件 API 与示例见 https://ampcode.com/docs/plugin-api,可用 amp plugins show-docs 查看当前版本支持的 API。

主要能力与位置:插件分三类位置——项目本地 .amp/plugins/、用户本地 ~/.config/amp/plugins/、以及跨机器的全局 User/Workspace Plugins 仓库。用 amp plugins list 列出项目本地插件,amp plugins repositories 查看全局仓库。仓库或应用专用插件放项目本地;沙箱中持久插件应放全局仓库;无明确指定时默认用户全局。

使用方式:用 amp plugins show-docs 了解 API 后编写插件,可包含 description 命名导出(≤300 字符)。本地目录插件可用 load_plugin 加载或重载,reload_plugins 重载全部。导入插件用 amp plugins import <url> --repository <clone-directory>,更新用 amp plugins update <name>。全局仓库工作在缓存克隆目录进行,提交后仅在用户明确要求或确认时才推送;推送后新线程自动加载新版本,已有线程需重载。插件可捆绑技能:目录插件将技能放 skills/<skill-name>/SKILL.md,并在加载时调用 amp.registerSkill 注册,技能名为 <plugin-name>:<skill-name>。

限制:插件是 TypeScript/JavaScript 扩展文件,不是 agent 模式、内置工具或 MCP 服务器。单文件插件无法注册技能;只有插件自身工具可被技能门控;未在技能中列出的工具始终可见。工作区管理员才能推送工作区导入,同名个人插件对其用户仍优先。若 load_plugin 不可用,需提示用户可能需重启 Amp 使改动生效。资料未提供收费、价格等信息。