用途
本技能是 Prisma CLI 与 Prisma Compute 反馈的终端入口。当用户希望把平台问题、部署缺陷、缺失功能或开放性问题交给 Prisma 团队时使用它。它负责分类问题、选择正确的反馈渠道、整理可公开的安全信息,并在用户确认后提交。
何时使用
- 用户说“这是个 bug”“提交这个”“发送反馈”或“功能请求”。
- app deploy、项目解析、分支解析、应用选择、认证、环境变量、日志或部署输出出现异常行为。
- 在认证、项目解析、部署、日志或验证过程中,CLI 命令挂起或约 30 秒内没有有用输出。
- 某个 Prisma CLI 技能的“What Prisma CLI doesn't do yet”部分指向此处。
- 用户想询问 Prisma 团队某种部署行为是否为预期行为。
何时不使用
- 用户希望智能体继续部署 Next.js 应用:应先用 prisma-cli-deploy-nextjs,只有确认是 CLI 或平台行为本身出错时才回到本技能。
- 问题出在用户自己的应用代码中,且可在本地修复。
- 请求针对的是 Prisma ORM 命令,而非 Prisma CLI beta。
渠道选择
使用 GitHub Issue 的情形:具体的 bug、具体的功能请求、误导性的 CLI 输出或错误码或下一步提示、可复现的部署/认证/项目/分支/应用/环境变量/日志问题。
使用 Discord 的情形:开放式的“这是预期行为吗”问题、需要先讨论再形成功能请求的设计反馈、没有具体 bug 或功能点的团队联系请求。
官方渠道:
- GitHub issues(bug 与具体功能请求):https://github.com/prisma/prisma-cli/issues/new/choose
- Prisma Discord(开放式问答与设计讨论):https://pris.ly/discord
未经用户明确确认,绝不提交公开 Issue。
需要收集的信息
收集最小化的公开安全上下文:
- Prisma CLI 版本:prisma-cli version
- Node 版本:node -v
- 包管理器及其版本
- 操作系统
- 执行的确切命令
- 完整输出(需脱敏)
- 命令是否挂起、运行了多久、中断后是否干净退出
- 使用的认证来源:PRISMA_SERVICE_TOKEN、已存储的 OAuth 或未认证。绝不打印 token 值。
- 如相关,可达性检查:https://auth.prisma.io 与 https://api.prisma.io/v1/me
- 应用是否为 Next.js,是否设置了 output: "standalone"
- 项目/分支/应用名称(仅在可安全分享时)
- 预期行为与实际行为
- 变通方法(如有)
标题与正文格式
Bug 标题:bug(<area>): <one-line summary>
Feature 标题:feat(<area>): <one-line summary>
可用 area:auth、project、branch、app、deploy、env、logs、docs、output、errors、skills。
Bug 正文模板:
CLI version
<output of prisma-cli version>
What happened?
<one-sentence summary plus relevant redacted output>
What did you expect to happen?
<one sentence>
Steps to reproduce
- <step one>
- <step two>
- <step three>
Environment
- Node: <version>
- OS: <platform/version>
- Package manager: <name/version>
- Framework: <Next.js/version if relevant>
Additional context
<optional>
Feature 正文模板:
What problem are you trying to solve?
<paragraph>
Proposed solution
<desired behavior or command shape>
Alternatives considered
<what the user tried today>
Scope and impact
<affected CLI command, docs, skill, or platform behavior>
提交方式
先向用户展示标题和正文,取得明确确认后再提交。
推荐提交流程:
- 将渲染后的正文写入真实的临时文件。
- 使用以下命令提交:
gh issue create --repo prisma/prisma-cli --title "<title>" --body-file <path>
不要通过 heredoc 或命令替换内联正文。
如果 gh 不可用,把 Issue URL 和渲染后的正文交给用户。
Discord 路径
对于问答或设计反馈,向用户提供 https://pris.ly/discord,并起草一条简短的开场消息,包含:
- 他们想部署或理解的内容
- Prisma CLI 版本
- 相关命令/输出(脱敏)
- 具体问题
不要自动发帖到 Discord。
限制
Prisma CLI 目前没有产品内反馈命令。GitHub issues 和 Discord 是当前的公开反馈渠道。如果用户想要 prisma-cli feedback 功能,可将其作为功能请求提交。
检查清单
- 已分类为 bug、功能请求或问答。
- 已脱敏秘密与私有数据。
- 已收集 CLI 版本、命令、输出、环境与复现步骤。
- 提交前已向用户展示标题/正文或 Discord 草稿。
- 仅在明确确认后才提交。