mcpField
P
positron-qa-verify

positron-qa-verify

github.com/posit-dev测试与质量4.3k57 次安装今天更新
代码仓库

关于 positron-qa-verify

Positron QA Verify 分析 Positron 的 GitHub issue 和 PR，生成手动 QA 验证指南，帮助测试人员从讨论和代码变更中整理测试场景与边界情况。

主要功能

  1. 01获取 issue 和 PR 详情
  2. 02分析相关讨论
  3. 03审查较小的 PR 差异
  4. 04生成 Markdown QA 指南
  5. 05按需检测版本信息

适用场景

  1. 01为缺陷修复准备 QA 测试
  2. 02从功能工单整理测试场景
  3. 03从 PR 讨论中查找边界情况
  4. 04为工单编写验证步骤

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posit-dev/positron --skill positron-qa-verify

安装后在 Claude Code 中输入/positron-qa-verify确认已加载。

附带文件references/verification_guide.mdscripts/detect_versions.sh

详细介绍

Positron QA 验证

分析 GitHub issues 和 PR，生成手动 QA 测试的验证指南。

使用场景

前置条件

  • 已通过身份验证的 GitHub CLI（gh）
  • 正在 Positron 仓库中工作

执行模式

重要：以非交互方式运行，不要提示用户。

  • 绝不使用 AskUserQuestion——始终写入 .claude/skills/positron-qa-verify/output/
  • 尽力检测版本——如果检测失败，静默使用空值
  • 快速失败——不要因超时或缺少数据而阻塞

输入

Issue 编号或 URL：

  • 4567
  • #4567
  • https://github.com/posit-dev/positron/issues/4567

工作流

步骤 1 和 2：获取 Issue 并查找 PR（并行）

在一条消息中通过多个 Bash 工具调用并行运行以下命令：

  • gh issue view <number> --repo posit-dev/positron --json title,body,comments,url,labels,author
  • gh pr list --repo posit-dev/positron --search "<number>" --state all --json number,title
步骤 3：分析 PR 上下文

获取主要 PR 的详细信息：

  • gh pr view <pr-number> --repo posit-dev/positron --json title,body,comments,additions,deletions,url

并行获取正文中提及的所有相关 PR 和 issue。

步骤 4：审查代码变更（有条件）

仅适用于少于 500 行的 PR（步骤 3 中的增删行数之和）：

  • gh pr diff <pr-number> --repo posit-dev/positron

对于大型 PR，跳过 diff，改用 PR 描述和评论。

步骤 5：提取关联的 Issue

在评论中查找 #1234 引用、其他测试场景、边缘情况和特定平台的注意事项。

步骤 6：生成验证指南

在 .claude/skills/positron-qa-verify/output/verify-issue-{number}-{timestamp}.md 中创建 Markdown 文件。

格式和示例请参阅 references/verification_guide.md。

步骤 7：提供验证评论模板

生成指南后，询问是否要创建验证评论模板。

仅在用户接受时：

  1. 运行 scripts/detect_versions.sh，自动检测 Positron 和 OS 版本
  2. 根据指南中的场景生成评论模板
  3. 复制到剪贴板

评论格式：

  • 单个场景（没有边缘情况或回归）：简易项目符号格式
  • 多个场景：分组格式，包含「主要场景」「边缘情况」「回归检查」部分

输出

.claude/skills/positron-qa-verify/output/verify-issue-{number}-{timestamp}.md

辅助脚本

scripts/detect_versions.sh

快速、静默地检测版本（最长 4 秒）：

./scripts/detect_versions.sh

输出：

{
  "positronVersion": "2026.02.0",
  "positronBuild": "10",
  "osVersion": "macOS 26.2",
  "detectionStatus": "success"
}

绝不提示用户或显示错误——失败时返回空值。

评论

支持 Markdown