技能包

按 CLI、SDK 和 OpenRouter 三路接入 InsForge

适合要让代理用 InsForge 做后端应用的人,前提是先装官方 skills add;后端走 CLI 技能,客户端走 SDK,新 AI 功能要先完成 ai setup,诊断只定位不给修复。

官方来源 · insforge-skills

安装

npx -y skills add insforge/insforge-skills

适合谁

你要用 AI 代理,借助 InsForge 这个 Backend-as-a-Service 来做应用时,用这组技能。源文写明它们帮助开发者通过代理构建应用。产品页是

https://insforge.dev/

技能仓库是

https://github.com/insforge/insforge-skills

源文给出一条关键区分:后端基础设施使用 CLI 技能;大多数客户端集成使用 @insforge/sdk;新的 AI 功能使用 OpenRouter API,密钥由 npx -y @insforge/cli ai setup 配置。还没有准备在本机执行官方安装、或不接受写入技能文件时,先不要继续。

另有一份诊断技能:它指导执行诊断命令来定位问题,不提供修复建议。不要指望它直接改代码。源文没有把后端能力展开成一张功能清单,不要自行补具体业务操作。只想在浏览器里点选 InsForge、又不准备让代理按 CLI 技能或 SDK 接线的人,也不必从这里起步。

3 分钟完成第一次尝试

先打开官方仓库核对:

https://github.com/insforge/insforge-skills

推荐安装只有这一条。装技能会改本机技能目录,执行前确认你要留下 InsForge 技能:

npx -y skills add insforge/insforge-skills

成功信号是这条命令正常结束。源文没有写技能落盘路径,不要自行补目录。源文还有面向特定客户端的插件市场装法,第一次不要并列成第二条主路径,也不要把市场命令套到未说明的环境。

第一次在代理里只做核对,不要先跑 ai setup,也不要发明诊断子命令。请代理复述那条关键区分:后端基础设施走 CLI 技能,客户端集成多用 @insforge/sdk,新 AI 功能走 OpenRouter,并且诊断只定位问题、不给修复建议。观察点是它能把这三路说清楚,并且还没有去配置密钥、也没有执行未出现的修复。

ai setup 会配置 API 密钥,属于副作用。只有当你确认要为新 AI 功能准备 OpenRouter 密钥时再运行:

npx -y @insforge/cli ai setup

源文没有写密钥字段名,不要写占位密钥。第一次不要把诊断技能当成自动修复。若代理主动提出要执行未出现的诊断命令,先让它说明「源文只写到指导定位,没有给出命令清单」,再停下。

使用案例

案例一:先按官方入口装上技能。在能接收 skills add 的代理里,确认你接受写入技能文件后,只运行 npx -y skills add insforge/insforge-skills。适合只想把 InsForge 技能接到代理、还不准备配密钥的人。成功信号是安装命令正常结束,并且代理能说出这是给 InsForge Backend-as-a-Service 用的。若安装失败,停下,不要改用插件市场那条当备用主路径。

案例二:先核对接线,再决定要不要配 AI 密钥。装好后,让代理复述:后端基础设施使用 CLI 技能,大多数客户端集成使用 @insforge/sdk,新 AI 功能使用 OpenRouter API,密钥由 npx -y @insforge/cli ai setup 配置;诊断技能只定位问题,不提供修复建议。适合担心代理会直接出网或乱改后端的人。成功信号是三路区分和诊断边界都被说清。真正运行 ai setup 前,确认你要留下密钥。源文没有给出诊断命令清单,不要编造。也不要把「帮助开发者构建应用」理解成已经给出了具体的创建或迁移步骤。

使用边界

主路径只有 npx -y skills add insforge/insforge-skills。源文另外写过插件市场安装,那不是第一次尝试的主路径,不要并列。产品页是

https://insforge.dev/

三路区分必须守住:后端基础设施走 CLI 技能,客户端集成多用 @insforge/sdk,新 AI 功能走 OpenRouter 并先完成 ai setup。诊断技能只指导定位问题,不提供修复建议。源文没有展开具体后端操作清单,也没有写技能目录、密钥字段或卸载步骤。没有写到的业务动作、修复命令和客户端名单,不要补全。第一次成功只看安装结束和代理能复述区分;配置密钥或执行诊断前必须先确认副作用。若代理开始给出修复步骤,先停下来,回到「只定位问题」。新 AI 功能在完成 ai setup 之前不要假装已经接好 OpenRouter。客户端集成不要绕过 @insforge/sdk 去编造另一套 SDK 名。后端基础设施也不要改用未出现的安装器。证据没写到卸载或更新路径,不要自行补命令。第一次成功只要求安装结束,加上代理能把 CLI 技能、SDK 和 OpenRouter 三路说清楚。