SuperAPI AI 工具集

prisma-cli-feedback

编程与开发

查看项目

更新于 10-16 05:40

技能介绍

用途

本技能是 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

  1. <step one>
  2. <step two>
  3. <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>

提交方式

先向用户展示标题和正文,取得明确确认后再提交。

推荐提交流程:

  1. 将渲染后的正文写入真实的临时文件。
  2. 使用以下命令提交:

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 草稿。
  • 仅在明确确认后才提交。