SuperAPI AI 工具集

create-plugin

设计与创作

查看项目

更新于 10-15 21:41

技能介绍

用途:帮助用户创建 OIAP 插件。OIAP 插件可一次编写,再导出为多个智能体平台(如 claude-code、codex、cursor、openclaw、vscode-copilot-chat、antigravity)的原生包。该技能面向以 npx skills 安装的智能体使用,OIAP 视为外部 SDK 与 CLI。

主要能力:先确认插件形态(帮助智能体做什么、目标平台、需要哪些原语、产物是否提交或发布)。若需求明确,直接搭建最小可用插件并说明扩展点。原语与用途对应:命令类动作用 invocations/instructions/commands;可复用提示包用 instructions/skills;常驻仓库指引用 rules;生命周期行为用 hooks;专用工作角色用 agents;外部工具或 MCP 用 tools;脚本化 shell 操作用 recipes 与 runtimeModules;权限与安全姿态用 policies。

使用方式:安装 npm 发布的 Node CLI 与 SDK:npm install --save-dev @oiap/cli @oiap/core;示例中使用 npx oiap targets、npx oiap build oiap.plugin.ts --target claude-code --out dist/claude-code、npx oiap build oiap.plugin.ts --out dist/oiap。编写 oiap.plugin.ts,默认导出 definePlugin(...),从 @oiap/core 导入,避免仓库相对导入;较长提示放在 Markdown 文件并用 markdownFile("path.md", { baseUrl: import.meta.url }) 加载。目标覆盖保持精简,优先可移植原语,如实声明 supportedTargets。涉及钩子、工具、脚本、网络、文件写入、密钥或破坏性操作时加入 policies。构建产物输出到 dist/,安装由宿主或用户流程负责。建议项目结构包含 package.json、tsconfig.json、oiap.plugin.ts 及 prompts/command.md 等,按需添加 agents/、schemas/、recipes/、policies/ 目录。

限制:不要在用户不是为 OIAP 本身贡献时让其克隆 OIAP 仓库。资料未提供定价、平台兼容以外的具体效果或更多细节。