mcpField
P
positron-qa-verify

positron-qa-verify

github.com/posit-devテスト・品質4.3k57 回インストール今日更新
リポジトリ

positron-qa-verify について

Positron QA Verifyは、PositronのGitHub issueとプルリクエストを分析し、手動QA向けの検証ガイドを作成します。チケットの議論やコード変更からテストシナリオと境界ケースを整理できます。

主な機能

  1. 01issueとPRの詳細取得
  2. 02関連する議論の分析
  3. 03小規模なPR差分の確認
  4. 04Markdown形式のQAガイド作成
  5. 05必要に応じたバージョン検出

活用シーン

  1. 01バグ修正のQAテスト準備
  2. 02機能チケットからのシナリオ作成
  3. 03PRの議論から境界ケースを抽出
  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 の Issue と 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 ツール呼び出しを含む 1 つのメッセージで、以下を並列に実行します：

  • 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 の差分は省略し、代わりに 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. クリップボードにコピーします

コメントの形式：

  • 単一のシナリオ（エッジケース／リグレッションなし）：シンプルな箇条書き形式
  • 複数のシナリオ：「Primary」「Edge cases」「Regression checks」セクションに分けた形式

出力

.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 対応