1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | prisma-compute-prisma-skills |
| 作者/维护者 | Prisma, Inc.(prisma 官方 GitHub 组织出品;子技能全部提交由 Prisma 团队成员 Aman Varshney 完成) |
| 来源链接 | https://github.com/prisma/skills/tree/main/prisma-compute |
| 许可证 | MIT(GitHub API 获取,仓库级) |
| GitHub Stars / Forks | 合集仓库整体 48 / 3(GitHub API 获取;该数字属整个 prisma/skills 合集,不代表本技能自身热度,取证方式见第 7 章) |
| 最新版本 | SKILL.md frontmatter 自带版本号 1.4.1(仓库未使用 GitHub Release 机制) |
| 安装方式 | npx skills add(详见第 10 章) |
2. 功能介绍与亮点
prisma-compute 是 Prisma 官方为其新推出的应用托管平台 Prisma Compute 编写的部署与运维指南,把“如何正确调用 Prisma Platform CLI 完成部署”这件事沉淀成结构化规则,而不是让 agent 靠猜测拼接命令:
- 证据优先级排序:明确规定 agent 判断该编辑/运行什么之前,必须先看项目已生成的脚本与配置(如
prisma.compute.ts、compute:deploy)、再看 CLI--help输出、再看已安装包代码,最后才查官方文档——避免凭记忆臆造已过时的命令 - 框架就绪度判定树:针对 Next.js、Hono、Nuxt、Astro、TanStack Start、NestJS、Turborepo 等多种框架,给出各自的部署可行性判断依据(如 Next.js 必须用 standalone 输出,不能假设
next start就是运行时入口) - 认证与工作区管理规则:区分
PRISMA_SERVICE_TOKEN环境变量与本地 OAuth 多工作区场景,规定二者的优先级与切换方式,明令不得在失败时静默回退到另一个已缓存的工作区 - 生产发布护栏:区分“仅构建候选版本供预览”(
--no-promote)与“正式提升为线上版本”(--prod --yes)两条路径,非交互式部署要求显式的鉴权来源,禁止打印任何 token - 内置问题反馈通道:CLI 崩溃或修复失败时,指导 agent 通过
@prisma/cli feedback命令上报,并明确要求消息中不得包含密钥、连接串或用户数据
3. 适用场景
所属分类:DevOps 与基础设施
适合已经在用 Prisma ORM、想把 TypeScript 应用连同数据库一起部署上线的开发者:无论是把新项目一键部署到 Prisma Compute、给已有应用做重新部署、排查部署构建失败的原因,还是搭建多应用 monorepo 的部署配置,都可以让 agent 按此技能给出的证据顺序与框架就绪度规则去执行,而不是现场摸索 CLI 参数。
4. 跨 Agent 兼容性
- Claude Code:官方支持——
agentskills.io的客户端展示页明确列出 Claude Code,且仓库自带CLAUDE.md说明文件专门指导 Claude Code 如何理解本仓库结构 - Codex:官方支持——
agentskills.io同一展示页明确列出 OpenAI Codex,仓库AGENTS.md也将 Codex 列为目标 agent 之一 - OpenClaw:未验证——抓取材料未点名,仅笼统声明遵循 Agent Skills 开放格式
- Hermes Agent:未验证,理由同上
5. 推荐理由
Prisma Compute 是 Prisma 官方 2026 年 6 月才公开测试版上线的新托管平台(应用与数据库同机部署、按分支自动建预览环境),产品迭代很快,CLI 参数和配置格式容易在几周内发生变化。这个技能把“先看项目已有配置和 CLI help,再动手”这条纪律写在最前面,加上覆盖近十种框架的就绪度判断、清晰的生产发布二次确认机制,能让 agent 在这个还在快速演进的平台上少踩“命令已过时”“端口没绑对导致部署假成功”这类坑。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Prisma 为知名 TypeScript ORM 官方厂商,子技能自身近一个月内有 5 次针对性提交(最近一次 2026-07-16,涵盖“教 CLI 反馈命令”“调整部署面”等具体改动),但全部提交出自同一人,仓库整体也仅 48 stars、该子技能未见外部 issue 或第三方独立讨论 |
| 可用性 | 8 | SKILL.md 结构完整(CLI 速查、决策树、按优先级分组的规则表、避免事项清单),近一个月持续维护;但实际部署需要 Prisma 账号与工作区鉴权(auth login 或 PRISMA_SERVICE_TOKEN),并非零配置复制即用 |
| 安全性 | 8 | 见下方检查清单 |
| 综合 | 7.7 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 指导 agent 调用 bunx @prisma/cli/create-prisma 等官方包装 CLI 完成部署、构建、日志查看等操作,范围明确且都是常规包管理器调用方式,无任意脚本执行 |
| ② 联网外发 | CLI 与 Prisma 自有平台(Console/Management API)通信,用于部署托管,属该技能功能本身所需且目标透明 |
| ③ 凭据存储 | 显式区分 PRISMA_SERVICE_TOKEN 与本地 OAuth 工作区两种鉴权来源,多处强调“禁止打印 token”“禁止在配置文件中提交密钥/连接串” |
| ④ 可疑指令 | 全文为部署流程规则与故障排查指引,未发现提示注入或隐蔽指令 |
| ⑤ 作者信誉 | Prisma 为知名开源数据库工具厂商,prisma 为其官方 GitHub 组织,主要提交者可查 |
| ⑥ License | MIT,明确 |
| ⑦ 维护时间 | 子目录最近一次提交 2026-07-16,约两周前,维护活跃 |
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| prisma-compute(本技能) | 部署到 Prisma Compute——应用与数据库同机托管,按 Git 分支自动生成带独立数据库的预览环境 | 部署目标与数据层深度绑定,适合已用 Prisma ORM 的项目一步到位 |
| Render 官方 render-deploy 技能(render-oss/skills) | 部署到 Render 通用 PaaS 平台 | 面向任意语言/框架的通用应用托管,数据库需单独置备,不与某个 ORM 绑定;仓库自带只读操作自动批准、写操作需二次确认的分级机制 |
| Prisma 自身的 prisma-postgres 技能(同合集仓库) | 只管理 Prisma Postgres 数据库本身(建库、连接、Console 操作) | 不涉及应用代码部署,是 prisma-compute 的数据层前置依赖而非替代品 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;其所依托的 Prisma Compute 产品本身有 Prisma 官方博客的公开测试版发布文章,但内容围绕平台功能介绍,未点名此 SKILL.md 技能包。
9. 其他补充
仓库同时收录 prisma-cli(ORM 命令参考)、prisma-client-api(Client API 参考)、prisma-postgres/prisma-postgres-setup(Postgres 数据库管理)、prisma-database-setup(多数据库连接配置)、prisma-upgrade-v7/prisma-mongodb-upgrade(版本升级指南)、prisma-driver-adapter-implementation(驱动适配器开发)等 8 个同类定位的 Prisma 官方技能,可按实际数据库与场景需求组合安装。
10. 安装使用方式
通用(Claude Code / Codex / 任何支持 Agent Skills 标准的工具):
npx skills add prisma/skills --skill prisma-compute
也可一次性安装该仓库全部 9 个 Prisma 技能:
npx skills add prisma/skills
列出该仓库全部可安装技能:
npx skills add prisma/skills --list
安装后无需重启;在对话中提出“帮我把这个应用部署到 Prisma Compute”或“重新部署我的 Prisma Compute 应用”即可触发。首次部署前需完成 @prisma/cli 的账号登录或配置 PRISMA_SERVICE_TOKEN 环境变量。
11. 注意事项
- Prisma Compute 目前为公开测试版(2026 年 6 月上线),测试期间免费使用,但功能与 CLI 参数仍可能较快变化,技能内容需要跟随平台迭代持续更新
- 部署前需要 Prisma 账号与鉴权配置(OAuth 登录或
PRISMA_SERVICE_TOKEN),并非零配置直接可用 - 目前支持的部署框架为 Next.js、Nuxt、Astro、Hono、NestJS、TanStack Start、Bun 及自定义构建产物,其余框架的部署就绪度需另行确认
- OpenClaw / Hermes Agent 的兼容性未见官方声明,跨 agent 使用前建议自行验证