qa-only

qa-only スキルの概要

qa-only は、Webアプリをテストし、バグを記録し、証拠を残す一方で、修正は一切行わないことを前提にしたレポート専用のQAスキルです。qa-only スキルは、テスト→修正→再検証のループではなく、クリーンなバグレポートの流れを求める QA レビュアー、プロダクトオーナー、エージェントに最適です。目的が「問題を見つけて報告する」ことであれば qa-only が適しています。コード変更をしたいなら、代わりに /qa を使ってください。

qa-only は何のためのスキルか

このスキルは、健全性スコア、スクリーンショット、再現手順、明確なバグレポートといった構造化された QA 出力にフォーカスします。「とにかくバグを確認したい」「テストはするが修正はしない」といった依頼向けに設計されているため、ユーザーが求めているのが実装ではなく証拠である場合の曖昧さを減らせます。

qa-only が他と違う理由

qa-only skill の最大の価値は、抑制にあります。エージェントを報告中心の振る舞いに誘導し、うっかり修正作業に入るのを避けるため、成果物がレビュー資料、トリアージメモ、引き継ぎレポートである場合に重要です。そのため、修正アクションが範囲外、またはリスクの高い環境では qa-only for Qa が特に有効です。

向いているケースと向いていないケース

既存アプリに対して QA を実施したいとき、特にバグ発見、回帰検出、書面での評価が必要な場合に qa-only を使ってください。コード編集、リファクタリング、反復的なバグ修正が必要なら、一般的なテスト支援ツールとして入れるべきではありません。qa-only guide はあくまで「修正より先に報告する」ことを前提にしており、修復優先ではありません。

qa-only スキルの使い方

スキルをインストールして検証する

インストールはリポジトリベースの流れで行います。npx skills add garrytan/gstack --skill qa-only を使ってください。インストール後は、実運用で頼る前に、skills ディレクトリ内にスキルファイルが存在し、読み取り可能であることを確認します。qa-only install は、QA 実行時にエージェントが実際にスキルのコンテキストを読み込めて初めて意味があります。

最初のプロンプトを適切に与える

良い qa-only usage プロンプトでは、アプリ、テスト対象、bug report only の意味、境界条件を明示してください。たとえば「staging 上の checkout フローで qa-only を実行し、目視で確認できるバグだけを報告し、再現手順とスクリーンショットのメモを含め、修正提案はしない」といった入力が適切です。「このアプリを QA して」のような弱い指示では、スコープや重大度をモデルが推測しすぎる余地が残ります。

先に読むべきファイル

まず SKILL.md を開き、次に SKILL.md.tmpl を確認して、生成されるワークフローがどのように組み立てられているかを把握してください。このリポジトリには追加の rules/、resources/、スクリプトが含まれていないため、動作、トリガー、制約の実質的な一次情報はこの 2 つのスキルファイルです。qa-only を導入する前に中身を理解したいなら、これが最短ルートです。

実務で使える QA ワークフローに組み込む

有効な qa-only guide の流れは、テストする範囲を決める → 期待される挙動を明確にする → スキルに集中的なレビューを実行させる → 出力をバグ一覧または QA メモにまとめる、というものです。最初の結果が広すぎる場合は、1 つのユーザージャーニー、1 つのデバイス/ブラウザ、1 つのリリース候補に絞ってください。タスクの境界が明確で、レポート形式がはっきりしているほど、このスキルは強く機能します。

qa-only スキル FAQ

qa-only はブラウザアプリ専用ですか？

ほぼその通りです。qa-only は Web アプリの QA とバグ報告を想定しているため、UI フロー、staging 環境、観察して文書化できるユーザージャーニーと相性が良いです。一方で、バックエンドのみの検証や、目に見える製品挙動がないタスクではあまり役に立ちません。

通常のプロンプトとどう違いますか？

通常のプロンプトでも QA は依頼できますが、qa-only skill では一貫したレポート姿勢と、「修正しない」ことに関する振る舞いがより明確になります。その結果、チームが欲しいのが分析と実装が混ざった結果ではなく、きれいな issue レポートである場合のやり取りが減ります。

qa-only は初心者向けですか？

はい。ただし、アプリ、環境、目的を言葉にできることが前提です。初心者がやりがちな失敗は、スコープを曖昧にすることです。qa-only guide は、何をテストし、どの証拠を集め、何をしないかを伝えるほどよく機能します。そこが曖昧だと、レポートが一般論すぎて実務に使いにくくなります。

どんなときに qa-only を使うべきではありませんか？

本当の目的がデバッグ、パッチ作成、E2E の修正確認であるなら qa-only は使わないでください。また、深いテスト自動化のセットアップ、インフラ作業、コード変更への書き込み権限が前提となる作業にも向きません。

qa-only スキルを改善するには

スコープを絞り、合格条件を強くする

qa-only の出力を改善する最も効果的な方法は、対象を 1 つに絞り、成功条件を 1 つ明確にすることです。たとえば「モバイル Safari で login フォームをテストし、バリデーション不具合を報告し、手順・期待値と実際の結果・スクリーンショット参照を含める」といった指定です。こうすると、曖昧な監査依頼ではなく、測定可能な枠組みをスキルに与えられます。

レポートに含めるべき証拠を足す

より役立つ qa-only レポートが欲しいなら、具体的な成果物を求めてください。再現手順、影響を受ける URL や route、重大度、発生頻度、blocking か cosmetic か intermittent か、などです。これは単に「バグを見つけて」と頼むよりも有効です。構造化された所見に落ちるため、他の人がすぐ動けるからです。

よくある失敗パターンに注意する

最も多い失敗は、範囲が広すぎることです。エージェントが何でもテストしようとして、レポートが浅くなります。もう 1 つの失敗は、レポート専用タスクに修正意図を混ぜてしまい、qa-only の目的が弱まることです。その場合は、「report only, no fixes, no code changes」と言い直し、テスト面を狭めてください。

1 回目のレポートから 2 回目の確認へつなげる

まず 1 回目で起こりそうな問題を見つけ、その後で重要なバグ経路に絞って 2 回目の qa-only を実行します。これは、最初のレポートでクリティカルなフローが見つかったものの、エッジケース、ブラウザ差、再現性まで深く確認したいときに特に有効です。反復して使うことで、qa-only は単発のプロンプトではなく、信頼できる QA の習慣になります。