AgentSkillsCN

qa-create

创建 QA 测试套件。利用 Playbook 的见解，通过 CDP 生成 Playwright 测试。

SKILL.md
--- frontmatter
name: qa-create
description: QA テストスイートを作成する。Playbook の知見を活用して CDP 経由の Playwright テストを生成。
allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Task, AskUserQuestion

MulmoCast の QA テストスイートを作成します。

手順

Step 1: Playbook と既存テストの読み込み

以下を読み込んでコンテキストに載せること:

  1. •Playbook: docs/qa_playbook.md — パターン・アンチパターン集
  2. •既存テスト一覧: test/ ディレクトリの QA テストファイル名を Glob で取得
  3. •テスト対象の理解: ユーザーが指定した機能に関連するソースコードを調査

Step 2: テスト対象の確認

ユーザーに以下を確認する:

  • •対象機能: 何をテストするか（例: 「新しい Settings セクション」「新しい UI コンポーネント」）
  • •API コスト: テスト中に外部 API を呼ぶか → ファイル名の no_api_ プレフィックスを決定
  • •スコープ: テスト範囲（UI のみ / JSON 連携含む / Settings 含む）
  • •前提条件: アプリの状態（Pro モード必須か、特定の設定が必要か）

Step 3: テスト設計

Playbook の「Phase 分割」に従ってテスト構成を設計する:

  1. •Phase 列挙: Setup → Core Feature → Integration → Health の順で Phase を定義
  2. •テスト項目リスト: 各 Phase のテスト項目を箇条書きで作成
  3. •双方向テスト: UI → JSON、JSON → UI の両方を含めること
  4. •空値テスト: Settings 空の状態でのテストを含めること

設計をユーザーに提示して承認を得る。

Step 4: テストコード生成

Playbook のパターンに従ってコードを生成する:

  1. •共通インフラ: connectCDP, findAppPage, record, createConsoleMonitor を Playbook から流用
  2. •CONFIG: テスト固有のタイミング定数を定義
  3. •ヘルパー関数: 既存テストから再利用できるヘルパーを特定し、必要に応じてコピーまたは新規作成
  4. •テスト関数: Phase ごとにテスト関数を作成
  5. •メイン IIFE: Phase の実行順序を定義、サマリ出力

Step 5: 実行と修正

テストが作成できたらユーザーに実行を依頼する（npx tsx test/{filename}.ts）。 結果に応じて修正を繰り返す。

Step 6: ドキュメント更新

  1. •test/README.md にテストの説明を追加
  2. •docs/qa_playbook.md に新しい知見があれば追記

重要なルール

  • •Playbook を必ず先に読むこと — 毎回 docs/qa_playbook.md を読み込んでからコードを書く
  • •Monaco の扱い — EDITOR_SETTLE_DELAY_MS を忘れない。JSON タブから離れる前に必ず待つ
  • •テスト値のユニーク性 — Date.now() ベースの runId で毎回異なる値を使う
  • •WARN を放置しない — WARN が出たら仕様かバグかユーザーに確認する
  • •新しい知見は Playbook に追記 — テスト作成中に発見したパターンは docs/qa_playbook.md に追加する